Browse Source

Fix name of the whole project. Argodejo -> Agordejo

tags/v0.1.1
Nils 1 year ago
parent
commit
3213ec5f3d
36 changed files with 2138 additions and 406 deletions
  1. +3
    -0
      CHANGELOG
  2. +5
    -5
      Makefile.in
  3. +10
    -10
      README.md
  4. +0
    -0
      agordejo
  5. +1
    -1
      configure
  6. +3
    -3
      desktop/agordejo-continue.desktop
  7. +3
    -3
      desktop/desktop.desktop
  8. +13
    -13
      documentation/argodejo.1
  9. +1
    -1
      documentation/build.py
  10. +44
    -44
      documentation/english.adoc
  11. +30
    -30
      documentation/english.part.adoc
  12. +41
    -41
      documentation/german.adoc
  13. +30
    -30
      documentation/german.part.adoc
  14. +1
    -1
      documentation/index.adoc
  15. +9
    -9
      documentation/manpageinclude.h2m
  16. +1
    -1
      documentation/nsm-data.1
  17. +45
    -45
      documentation/out/english.html
  18. +42
    -42
      documentation/out/german.html
  19. +2
    -2
      documentation/out/index.html
  20. +1
    -1
      engine/api.py
  21. +6
    -6
      engine/config.py
  22. +16
    -16
      engine/findprograms.py
  23. +21
    -21
      engine/nsmservercontrol.py
  24. +1
    -1
      qtgui/designer/mainwindow.py
  25. +1
    -1
      qtgui/designer/mainwindow.ui
  26. +1
    -1
      qtgui/designer/settings.py
  27. +1
    -1
      qtgui/designer/settings.ui
  28. +8
    -8
      qtgui/mainwindow.py
  29. +9
    -9
      qtgui/opensessioncontroller.py
  30. +18
    -18
      qtgui/quickopensessioncontroller.py
  31. BIN
      qtgui/resources/translations/de.qm
  32. +14
    -14
      qtgui/resources/translations/de.ts
  33. +3
    -3
      qtgui/systemtray.py
  34. +24
    -24
      tools/nsm-data
  35. +0
    -1
      tools/nsmservercontrol.py
  36. +1730
    -0
      tools/nsmservercontrol.py

+ 3
- 0
CHANGELOG View File

@@ -1,3 +1,6 @@
2020-10-15 0.2
Correct typo in the name of the project :) Sorry.

2020-07-15 0.1 Proof of Concept
A lot is working already, single-computer session are working fine.
Network sessions of any form are not usable yet.

+ 5
- 5
Makefile.in View File

@@ -34,14 +34,14 @@ install:
#nsm-data
install -D -m 755 "nsm-data.bin" $(DESTDIR)$(PREFIX)/bin/nsm-data

#Argodejo
#Agordejo
install -D -m 755 $(PROGRAM).bin $(DESTDIR)$(PREFIX)/bin/$(PROGRAM)
install -D -m 644 documentation/out/* -t $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)
install -D -m 644 README.md $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)/README.md
install -D -m 644 LICENSE $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)/LICENSE

install -D -m 644 desktop/desktop.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo.desktop
install -D -m 644 desktop/argodejo-continue.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo-continue.desktop
install -D -m 644 desktop/desktop.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo.desktop
install -D -m 644 desktop/agordejo-continue.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo-continue.desktop

install -d $(DESTDIR)$(PREFIX)/share/man/man1
gzip -c documentation/$(PROGRAM).1 > $(DESTDIR)$(PREFIX)/share/man/man1/$(PROGRAM).1.gz
@@ -66,8 +66,8 @@ uninstall:
#Files
rm -f $(DESTDIR)$(PREFIX)/bin/$(PROGRAM)
rm -f $(DESTDIR)$(PREFIX)/bin/nsm-data
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo-continue.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo-continue.desktop
rm -f $(DESTDIR)$(PREFIX)/share/man/man1/$(PROGRAM).1.gz

#Icons

+ 10
- 10
README.md View File

@@ -1,11 +1,11 @@

[//]: # (Generated 2020-06-11T19:20:27.804895. Changes belong into template/documentation/readme.template)

#Argodejo
#Agordejo
Program version 0.1


Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.

@@ -14,7 +14,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.


Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.


@@ -24,7 +24,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.


That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.


@@ -35,7 +35,7 @@ This README is just a short introduction. Consult the manual (see below) for mor
* Website https://www.laborejo.org
* Bugs and Issues: https://www.laborejo.org/bugs
* Git Repositories for all programs: https://git.laborejo.org
* Documentation and Manual https://www.laborejo.org/documentation/argodejo
* Documentation and Manual https://www.laborejo.org/documentation/agordejo

# Installation and Starting

@@ -48,7 +48,7 @@ Download the latest code release on https://www.laborejo.org/downloads and extra
### Git Version
It is possible to clone a git repository.

`git clone https://git.laborejo.org/lss/argodejo.git`
`git clone https://git.laborejo.org/lss/agordejo.git`

## Dependencies
* Glibc
@@ -73,11 +73,11 @@ It is possible to clone a git repository.

## Starting

If you installed Argodejo through a packager manager or yourself simple use your application launcher
or terminal to start the executable `argodejo`
If you installed Agordejo through a packager manager or yourself simple use your application launcher
or terminal to start the executable `agordejo`

You can also run Argodejo after extracting the release archive or cloning from git, without make or
You can also run Agordejo after extracting the release archive or cloning from git, without make or
installation. If you did so, for additional features please link tools/nsm-data to your executable PATH.

Use the manpage `man argodejo` or run `argodejo --help` (or local variant `./argodejo --help` )
Use the manpage `man agordejo` or run `agordejo --help` (or local variant `./agordejo --help` )
to see available command line parameters.

argodejo → agordejo View File


+ 1
- 1
configure View File

@@ -1,4 +1,4 @@
program=argodejo
program=agordejo
version=0.1

#debugsym=true

desktop/argodejo-continue.desktop → desktop/agordejo-continue.desktop View File

@@ -1,9 +1,9 @@
[Desktop Entry]
Type=Application
Name=Argodejo Continue
Name=Agordejo Continue
Comment=Music and audio production session manager based on NSM. Continue last session, start as TrayIcon.
Exec=argodejo --continue --hide
Icon=argodejo
Exec=agordejo --continue --hide
Icon=agordejo
Terminal=false
StartupNotify=false
Version=1.0

+ 3
- 3
desktop/desktop.desktop View File

@@ -1,9 +1,9 @@
[Desktop Entry]
Type=Application
Name=Argodejo
Name=Agordejo
Comment=Music and audio production session manager based on NSM.
Exec=argodejo
Icon=argodejo
Exec=agordejo
Icon=agordejo
Terminal=false
StartupNotify=false
Version=1.0

+ 13
- 13
documentation/argodejo.1 View File

@@ -1,14 +1,14 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.15.
.TH ARGODEJO "1" "June 2020" "Argodejo 0.1" "User Commands"
.TH ARGODEJO "1" "June 2020" "Agordejo 0.1" "User Commands"
.SH NAME
Argodejo - Music and audio production session manager based on NSM.
Agordejo - Music and audio production session manager based on NSM.
.SH DESCRIPTION
usage: argodejo [\-h] [\-v] [\-V] [\-u URL] [\-\-nsm\-url URL] [\-s SESSION] [\-c] [\-i]
usage: agordejo [\-h] [\-v] [\-V] [\-u URL] [\-\-nsm\-url URL] [\-s SESSION] [\-c] [\-i]
.IP
[\-\-session\-root SESSIONROOT]
.PP
Argodejo \- Version 0.1 \- Copyright 2020 by Laborejo Software Suite \-
https://www.laborejo.org/argodejo
Agordejo \- Version 0.1 \- Copyright 2020 by Laborejo Software Suite \-
https://www.laborejo.org/agordejo
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR
@@ -47,7 +47,7 @@ Root directory of all sessions. Defaults to '$HOME/NSM
Sessions'
.SH USAGE

Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.

@@ -56,7 +56,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.


Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.


@@ -66,21 +66,21 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.


That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
.SH EXAMPLES
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.
.SH "REPORTING BUGS"
https://www.laborejo.org/bugs
.SH COPYRIGHT
Argodejo 0.1 - Copyright 2020
Agordejo 0.1 - Copyright 2020
Laborejo Software Suite
https://www.laborejo.org/
.SH "SEE ALSO"
The full documentation for Argodejo is maintained as a multi-lingual html site to your systems doc-dir.
The full documentation for Agordejo is maintained as a multi-lingual html site to your systems doc-dir.
For example:
xdg-open file:///usr/share/doc/argodejo/index.html
xdg-open file:///usr/share/doc/agordejo/index.html

The documentation can also be found online https://www.laborejo.org/documentation/argodejo
The documentation can also be found online https://www.laborejo.org/documentation/agordejo

+ 1
- 1
documentation/build.py View File

@@ -102,7 +102,7 @@ https://www.laborejo.org/bugs
https://www.laborejo.org/

[examples]
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.


+ 44
- 44
documentation/english.adoc View File

@@ -22,7 +22,7 @@ https://asciidoctor.org/docs/user-manual/
:toc-title: Table of Contents
:toclevels: 3

= Argodejo
= Agordejo

// Don't write in the empty line above line. It will be interpreted as author html tag
For program version 0.1
@@ -30,7 +30,7 @@ For program version 0.1
== Introduction


Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.

@@ -39,7 +39,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.


Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.


@@ -49,7 +49,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.


That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.


@@ -74,25 +74,25 @@ real time, have synchronized timelines and play in the same tempo.

What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.

In contrast to the self-written script mentioned above, you don't have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.
setup, but everything is saved automatically as long as you manage everything through Agordejo.

=== Example

* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Now you get a choice of programs:
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.
* To get more programs and advanced features you can switch to the tab "Full View
* The name of the session so far is simply a date. By clicking on it you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by pressing the button "Save and Close"
* Now Argodejo could be closed itself.
* Now Agordejo could be closed itself.
* All stored data is in a single directory on the hard disk (`~/NSM Sessions/My Song`)
* The session can be resumed: After clicking on the name, all programs start automatically and connect their JACK ports to among themselves.

@@ -106,7 +106,7 @@ decisions as possible and start an old session or create a new one as quickly as
at least clicks).

For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.
work correctly with Agordejos session management.

The Quick View is only a view. There is no technical difference to the full view and you can switch
back and forth at any time.
@@ -184,10 +184,10 @@ Each session has a context menu (e.g. right mouse button) with further options:
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don't need to restart Argodejo to do this, it will respond to the changes while running.
don't need to restart Agordejo to do this, it will respond to the changes while running.

There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@@ -221,7 +221,7 @@ The following information is available per program:
* The program status
* Stopped , not running
* Ready, running
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)
* Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
@@ -250,12 +250,12 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Abort ends the session without saving the programs
* Save As saves the session under a different name and closes the current session without saving. From now on you work under the new name.
* Add Client offers the option to add any program, whether it is in the program database or not.
* Any installed programs are suggested. Argodejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `argodejo` itself.
* Any installed programs are suggested. Agordejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `agordejo` itself.

== Program-Database

Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.

The database is created at the first start. Depending on your system, this can take some moments to
@@ -263,7 +263,7 @@ a few minutes.

If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.

If you do not see an installed program in our launcher, but you are sure that it supports session
@@ -287,10 +287,10 @@ These search paths are not stored in the session, but locally in your `~/.config

== Tray

Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.

If you close Argodejo using the normal window manager function, such as a click on the [X], the
If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.

A right click on the icon gives you access to common functions:
@@ -299,7 +299,7 @@ You can directly start the most recently used sessions.

If a session is already running you can save, cancel etc.

Argodejo can also be completely exited here.
Agordejo can also be completely exited here.


== Network Sessions
@@ -310,26 +310,26 @@ version.

== Program parameters

As an advanced user, you can start Argodejo in the terminal and add some parameters.. For a
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
complete list please use the --help parameter.

For example:

* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active session.
* `--hide` starts Argodejo as TrayIcon.
* `--hide` starts Agordejo as TrayIcon.
* `--url osc.udp://myhost.localdomain:14294/` connects to this server, if available, or starts the internal session server at this address. This is a very technical option and probably not needed.
* `--session-root /home/user/production2030` sets the root directory. Only sessions in this directory are displayed, everything is stored here.

The combination of `--continue` and `--hide` is essentially what many people expect from Session
Management: Resuming at the previous state, without any extra windows in their way.
If your system uses a start menu you will find not only the normal Argodejo starter but also
"Argodejo Continue" to start this mode directly.
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Agordejo Continue" to start this mode directly.


== Miscellaneous / Explanations / FAQ

*Session Save and Exit responds slowly*: Argodejo is not a standalone program like an word
*Session Save and Exit responds slowly*: Agordejo is not a standalone program like an word
processor. The participating programs in the session are not plugins either. When you end the
session a signal is sent to all participating client to save. This may take a few moments where
you are able to see "live" how individual programs terminate and disappear from the session.
@@ -337,7 +337,7 @@ Everything is fine.


*I have added a program but it does not save with the session*: Does the program support session
management? If not, Argodejo cannot do much. But you can ask the program developers to contact us
management? If not, Agordejo cannot do much. But you can ask the program developers to contact us
(info@laborejo.org) and we can work together on support.


@@ -346,13 +346,13 @@ we are also interested in improving the situation by offering at least an emerge
future.


*Argodejo won't start! I start the program but I can't see anything*: Most likely Argodejo is
*Agordejo won't start! I start the program but I can't see anything*: Most likely Agordejo is
running, but invisible, because you exited it from the tray last time. Is it in the tray? A
message should have popped up, maybe you missed it. If there is no tray in your window manager, the
program should always be visible. With all these special window managers in Linux it may be that
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Argodejo will behave like the
`~/.config/LaborejoSoftwareSuite/agordejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.


@@ -366,7 +366,7 @@ inevitable crashes).


*A program update broke my session because it can no longer load its files.* Unfortunately, this is
a problem that even Argodejo can't solve. It also happens with LV2 plugins and with all other
a problem that even Agordejo can't solve. It also happens with LV2 plugins and with all other
software, such as office programs. If you fear that a program becomes incompatible in the future,
write down its version number in the session notes, so that you can at least, in an emergency,
reinstall the old program version (even if this is very is cumbersome).
@@ -376,7 +376,7 @@ reinstall the old program version (even if this is very is cumbersome).
management is worthwhile with two or more participating programs, which one needs almost always.

You should not feel compelled to suddenly make everything modular with individual programs, only
because you use a session manager. Argodejo is designed to make your music production easier. If it
because you use a session manager. Agordejo is designed to make your music production easier. If it
is faster and more comfortable to manage all plugins and effects e.g. in a single "Carla" instance
then you should do exactly that. If you basically want to do everything in Ardour, do that, but
start Ardour anyway in session management, because no program can do everything alone and the time
@@ -393,7 +393,7 @@ directly do music production, but still is connected in the grander scheme: Ope
(OBS), music player, word processors and graphic programs etc.


*Argodejo contains functionality which is not within its scope*: Music production is very complex
*Agordejo contains functionality which is not within its scope*: Music production is very complex
and complexity is inevitable. It's like a waterbed: if you press down on one side, something
bounces up in another place. When you create a "clean and lean" program, which therefore implements
only a part of the complete workflow, then the missing part pops up somewhere else. A minimalistic
@@ -402,23 +402,23 @@ session manager provokes plug-ins (not LV2), helper-scripts, workarounds and hac
E.g. not to include file management provokes user errors like deleting the wrong files. If the SM
knows what to do and it can do it, then let it do it. Or crashes: Technically, crashing programs
are not the "problem" of the session managers, but they are part of the software reality. Crashes
happen every day and need to be handled. Can Argodejo simplify the work and help to restore good
happen every day and need to be handled. Can Agordejo simplify the work and help to restore good
conditions again? Then that should be done. Session management is also an opportunity to simplify
even complex technical scenarios, e.g. distributing sessions over the network.


== Installation and Start

Argodejo is exclusive for Linux. The best way to install is to use your package manager.
Agordejo is exclusive for Linux. The best way to install is to use your package manager.
If it is not there, or only in an outdated version, please ask your Linux distribution to provide a recent version.

If not available in the package repository you can build Argodejo yourself.
If not available in the package repository you can build Agordejo yourself.

.Build and Install
* Please check the supplied README.md for dependencies.
* You can download a release or clone the git version
** Download the latest version from https://www.laborejo.org/downloads and extract it.
** git clone https://git.laborejo.org/lss/argodejo.git
** git clone https://git.laborejo.org/lss/agordejo.git
* Change into the new directory and use these commands:
* `./configure --prefix=/usr`
** The default prefix is /usr/local
@@ -426,14 +426,14 @@ If not available in the package repository you can build Argodejo yourself.
* `sudo make install`


Now the program is available to run via your menu/launcher or `argodejo` in a terminal.
Now the program is available to run via your menu/launcher or `agordejo` in a terminal.

Please read README.md for other ways of starting argodejo, which are impractical for actual use but can
Please read README.md for other ways of starting agordejo, which are impractical for actual use but can
be helpful for testing and development.


== Help and Development
You can help Argodejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.
You can help Agordejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.

=== Testing and Reporting Errors
If you find a bug in the program (or it runs too slow) please contact us in a way that suits you best.
@@ -450,7 +450,7 @@ If you want to do some programming and don't know where to start please get in c
The short version is: clone the git, change the code, create a git patch or point me to your public git.

=== Translations
Argodejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
Agordejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
The easiest way is to contact the developers and they will setup the new language.

However, here are the complete instructions for doing a translation completely on your own and integrating it into the program.
@@ -468,7 +468,7 @@ You can add a new language like this:
* Select your "Target Language" and use the program to create a translation
* Send us the `.ts` file, such as by e-mail to info@laborejo.org

You can also incorporate the translation into Argodejo for testing purposes. This requires rudimentary Python knowledge.
You can also incorporate the translation into Agordejo for testing purposes. This requires rudimentary Python knowledge.

* Run the "Release" option in QtLinguists "File" menu. It creates a `.qm` file in the same directory as your `.ts` file.
* Edit `qtgui/resources/resources.qrc` and duplicate the line `<file>translations/de.qm</file>` but change it to your new .qm file.
@@ -477,6 +477,6 @@ You can also incorporate the translation into Argodejo for testing purposes. Thi
** To find out your language string (German, Esperanto etc.) open the `python3` interpreter in a terminal and run the following command:
** `from PyQt5 import QtCore;QtCore.QLocale().languageToString(QtCore.QLocale().language())`

To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start argodejo via the terminal:
To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start agordejo via the terminal:

* `LANGUAGE=de_DE.UTF-8 ./argodejo -V --save /dev/null`
* `LANGUAGE=de_DE.UTF-8 ./agordejo -V --save /dev/null`

+ 30
- 30
documentation/english.part.adoc View File

@@ -19,25 +19,25 @@ real time, have synchronized timelines and play in the same tempo.

What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.

In contrast to the self-written script mentioned above, you don't have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.
setup, but everything is saved automatically as long as you manage everything through Agordejo.

=== Example

* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Now you get a choice of programs:
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.
* To get more programs and advanced features you can switch to the tab "Full View
* The name of the session so far is simply a date. By clicking on it you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by pressing the button "Save and Close"
* Now Argodejo could be closed itself.
* Now Agordejo could be closed itself.
* All stored data is in a single directory on the hard disk (`~/NSM Sessions/My Song`)
* The session can be resumed: After clicking on the name, all programs start automatically and connect their JACK ports to among themselves.

@@ -51,7 +51,7 @@ decisions as possible and start an old session or create a new one as quickly as
at least clicks).

For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.
work correctly with Agordejos session management.

The Quick View is only a view. There is no technical difference to the full view and you can switch
back and forth at any time.
@@ -129,10 +129,10 @@ Each session has a context menu (e.g. right mouse button) with further options:
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don't need to restart Argodejo to do this, it will respond to the changes while running.
don't need to restart Agordejo to do this, it will respond to the changes while running.

There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@@ -166,7 +166,7 @@ The following information is available per program:
* The program status
* Stopped , not running
* Ready, running
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)
* Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
@@ -195,12 +195,12 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Abort ends the session without saving the programs
* Save As saves the session under a different name and closes the current session without saving. From now on you work under the new name.
* Add Client offers the option to add any program, whether it is in the program database or not.
* Any installed programs are suggested. Argodejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `argodejo` itself.
* Any installed programs are suggested. Agordejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `agordejo` itself.

== Program-Database

Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.

The database is created at the first start. Depending on your system, this can take some moments to
@@ -208,7 +208,7 @@ a few minutes.

If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.

If you do not see an installed program in our launcher, but you are sure that it supports session
@@ -232,10 +232,10 @@ These search paths are not stored in the session, but locally in your `~/.config

== Tray

Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.

If you close Argodejo using the normal window manager function, such as a click on the [X], the
If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.

A right click on the icon gives you access to common functions:
@@ -244,7 +244,7 @@ You can directly start the most recently used sessions.

If a session is already running you can save, cancel etc.

Argodejo can also be completely exited here.
Agordejo can also be completely exited here.


== Network Sessions
@@ -255,26 +255,26 @@ version.

== Program parameters

As an advanced user, you can start Argodejo in the terminal and add some parameters.. For a
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
complete list please use the --help parameter.

For example:

* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active session.
* `--hide` starts Argodejo as TrayIcon.
* `--hide` starts Agordejo as TrayIcon.
* `--url osc.udp://myhost.localdomain:14294/` connects to this server, if available, or starts the internal session server at this address. This is a very technical option and probably not needed.
* `--session-root /home/user/production2030` sets the root directory. Only sessions in this directory are displayed, everything is stored here.

The combination of `--continue` and `--hide` is essentially what many people expect from Session
Management: Resuming at the previous state, without any extra windows in their way.
If your system uses a start menu you will find not only the normal Argodejo starter but also
"Argodejo Continue" to start this mode directly.
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Agordejo Continue" to start this mode directly.


== Miscellaneous / Explanations / FAQ

*Session Save and Exit responds slowly*: Argodejo is not a standalone program like an word
*Session Save and Exit responds slowly*: Agordejo is not a standalone program like an word
processor. The participating programs in the session are not plugins either. When you end the
session a signal is sent to all participating client to save. This may take a few moments where
you are able to see "live" how individual programs terminate and disappear from the session.
@@ -282,7 +282,7 @@ Everything is fine.


*I have added a program but it does not save with the session*: Does the program support session
management? If not, Argodejo cannot do much. But you can ask the program developers to contact us
management? If not, Agordejo cannot do much. But you can ask the program developers to contact us
(info@laborejo.org) and we can work together on support.


@@ -291,13 +291,13 @@ we are also interested in improving the situation by offering at least an emerge
future.


*Argodejo won't start! I start the program but I can't see anything*: Most likely Argodejo is
*Agordejo won't start! I start the program but I can't see anything*: Most likely Agordejo is
running, but invisible, because you exited it from the tray last time. Is it in the tray? A
message should have popped up, maybe you missed it. If there is no tray in your window manager, the
program should always be visible. With all these special window managers in Linux it may be that
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Argodejo will behave like the
`~/.config/LaborejoSoftwareSuite/agordejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.


@@ -311,7 +311,7 @@ inevitable crashes).


*A program update broke my session because it can no longer load its files.* Unfortunately, this is
a problem that even Argodejo can't solve. It also happens with LV2 plugins and with all other
a problem that even Agordejo can't solve. It also happens with LV2 plugins and with all other
software, such as office programs. If you fear that a program becomes incompatible in the future,
write down its version number in the session notes, so that you can at least, in an emergency,
reinstall the old program version (even if this is very is cumbersome).
@@ -321,7 +321,7 @@ reinstall the old program version (even if this is very is cumbersome).
management is worthwhile with two or more participating programs, which one needs almost always.

You should not feel compelled to suddenly make everything modular with individual programs, only
because you use a session manager. Argodejo is designed to make your music production easier. If it
because you use a session manager. Agordejo is designed to make your music production easier. If it
is faster and more comfortable to manage all plugins and effects e.g. in a single "Carla" instance
then you should do exactly that. If you basically want to do everything in Ardour, do that, but
start Ardour anyway in session management, because no program can do everything alone and the time
@@ -338,7 +338,7 @@ directly do music production, but still is connected in the grander scheme: Ope
(OBS), music player, word processors and graphic programs etc.


*Argodejo contains functionality which is not within its scope*: Music production is very complex
*Agordejo contains functionality which is not within its scope*: Music production is very complex
and complexity is inevitable. It's like a waterbed: if you press down on one side, something
bounces up in another place. When you create a "clean and lean" program, which therefore implements
only a part of the complete workflow, then the missing part pops up somewhere else. A minimalistic
@@ -347,6 +347,6 @@ session manager provokes plug-ins (not LV2), helper-scripts, workarounds and hac
E.g. not to include file management provokes user errors like deleting the wrong files. If the SM
knows what to do and it can do it, then let it do it. Or crashes: Technically, crashing programs
are not the "problem" of the session managers, but they are part of the software reality. Crashes
happen every day and need to be handled. Can Argodejo simplify the work and help to restore good
happen every day and need to be handled. Can Agordejo simplify the work and help to restore good
conditions again? Then that should be done. Session management is also an opportunity to simplify
even complex technical scenarios, e.g. distributing sessions over the network.

+ 41
- 41
documentation/german.adoc View File

@@ -22,7 +22,7 @@ https://asciidoctor.org/docs/user-manual/
:toc-title: Inhaltsverzeichnis
:toclevels: 3

= Argodejo
= Agordejo

// Don't write in the empty line above line. It will be interpreted as author html tag
Für Programmversion 0.1
@@ -50,28 +50,28 @@ Echtzeit teilen, verfügen über synchronisierte Timelines und spielen im gleich

Was übrig bleibt ist die leidige Arbeit jedesmal alle Programme zu starten, die Projektdateien zu
laden, alle Audiokanäle zu verbinden usw. Session Management im allgemeinen (z.B. extra
geschriebene Starter-Scriptdateien) und Argodejo im speziellen nehmen Ihnen diese Arbeit ab, oder
geschriebene Starter-Scriptdateien) und Agordejo im speziellen nehmen Ihnen diese Arbeit ab, oder
vereinfachen sie zumindest stark.

Im Gegensatz zum erwähnten selbstgeschriebenen Script müssen Sie sich nicht im Vorraus für ein
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.


=== Anwendungsbeispiel

* Argodejo starten (Startmenü, Terminal etc.)
* Agordejo starten (Startmenü, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der große Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschließend) dessen grafische Oberfläche
* Sollte das Programm abstürzen bekommt man das signalisiert und kann es neustarten.
* Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Argodejo gespeichert.
* Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.
* Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln
* Der Name der Session ist bisher einfach ein Datum. Durch Klick auf dieses kann man einen richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Knopf "Speichern und Schließen" wieder in die Sessionauswahl zurück
* Nun könnte Argodejo geschlossen werden.
* Nun könnte Agordejo geschlossen werden.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/NSM Sessions/Mein Lied`)
* Die Session kann weitergeführt werden: Nach dem Klick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.

@@ -87,7 +87,7 @@ Entscheidungen wie möglich zu treffen haben und so schnell wie möglich (mit de
eine alte Session starten oder eine neue erstellen können.

Aus Stabilitätsgründen werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Argodejos zusammenarbeiten.
korrekt mit dem Session Management Agordejos zusammenarbeiten.

Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie können jederzeit hin- und herschalten.
@@ -167,7 +167,7 @@ Jede Session verfügt über ein Kontextmenü (z.B. rechte Maustaste) mit weitere
eine Session umbennen, löschen (inkl. aller dazugehörigen Dateien auf der Festplatte!) und mehr.
Diese Funktionen sind gleichwertig zu ihrem Dateimanager. Falls Sie möchten, können Sie auch
einfach die Sessionverzeichnisse selbst umbennen, verschieben oder löschen (sofern diese nicht
gerade geöffnet ist). Dazu muss Argodejo nicht neugestartet werden, es reagiert selbst auf die
gerade geöffnet ist). Dazu muss Agordejo nicht neugestartet werden, es reagiert selbst auf die
Änderungen.

Hier gibt es auch die Möglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
@@ -206,7 +206,7 @@ Pro Programm gibt es folgende Informationen:
* Den Programmstatus (auf Englisch, da es sich um definierte Schlüsselworte handelt).
* Stopped / Gestoppt, läuft nicht
* Ready / Läuft und Bereit
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Argodejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Agordejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
* Weitere Zustände sind nur Übergänge und meist nur sehr kurz zu sehen, z.B. Open / Läd gerade
* Sichtbarkeit (Ein Kreuz für sichtbar, Leer für unsichtbar)
* Änderungen - Gibt es momentan ungespeicherte Änderungen?
@@ -237,13 +237,13 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menüs zur Verfügung, di
* Abbrechen beendet die Session, ohne dass die Programme abspeichern
* Speichern Unter speichert die Session unter einem anderen Namen und schließt die laufende ohne abzuspeichern. Ab nun arbeitet man in der neuen Session.
* Client Hinzufügen bietet die Option ein beliebiges Programm hinzuzufügen, egal ob es in der Programmdatenbank ist, oder nicht.
* Es werden alle installierten Programme vorgeschlagen. Argodejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier `ls` wie auch `argodejo` selbst.
* Es werden alle installierten Programme vorgeschlagen. Agordejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier `ls` wie auch `agordejo` selbst.

== Programm-Datenbank

Argodejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
Agordejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
teilweise von Hand eingepflegt wurde. Das bedeutet nichts anderes, als das alle installieren
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Argodejo-Starter nur
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Agordejo-Starter nur
das angeboten wird, was Sie auch tatsächlich installiert haben.

Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
@@ -251,7 +251,7 @@ Augenblicke bis einige Minuten dauern.

Wenn Sie Audio-Programme neu installieren, oder deinstallieren müssen Sie die Datenbank selbst
aktualisieren. Im Steuerungsmenü gibt es den Befehl. Programminstallationen sind sogar möglich
während Argodejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
während Agordejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
neuen Programme zur Verfügung.

Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@@ -279,10 +279,10 @@ Verzeichnis.

== Tray

Argodejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
Agordejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Agordejo.

Schließt man Argodejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Schließt man Agordejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Programm und die Session nicht beendet, sondern in den Tray minimiert.

Ein Rechtsklick auf das Icon bietet Schnellzugriff auf häufige Funktionen:
@@ -291,7 +291,7 @@ Sie können hier die zuletzt benutzen Sessions direkt starten.

Läuft bereits eine Session können Sie speichern, abbrechen etc.

Argodejo kann hier auch komplett beendet werden.
Agordejo kann hier auch komplett beendet werden.

== Netzwerk-Sessions

@@ -301,25 +301,25 @@ vorgesehen.

== Programmparameter

Als fortgeschrittener Benutzer können Sie Argodejo im Terminal starten und dort einige Parameter
Als fortgeschrittener Benutzer können Sie Agordejo im Terminal starten und dort einige Parameter
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.

Eine Auswahl:

* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte Session
* `--hide` startet Argodejo als Trayicon.
* `--hide` startet Agordejo als Trayicon.
* `--url osc.udp://myhost.localdomain:14294/` verbindet sich zu diesem Server, falls vorhanden, oder startet den internen Session-Server unter dieser Adresse. Dies ist eine sehr technische Option und wird wahrscheinlich nicht benötigt.
* `--session-root /home/benutzer/produktion2020` setzt das Wurzelverzeichnis. Nur Sessions in diesem Verzeichnis werden angezeigt, alles wird dort gespeichert.

Die Kombination von `--continue` und `--hide` ergibt einen Modus, den viele Leute vom Session Management
erwarten: dort weiter machen wo man aufgehört hat, ohne dass Extrafenster angezeigt werden.
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Argodejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.

== Verschiedenes / Erklärungen / FAQ

*Session Speichern und Beenden reagiert langsam*: Argodejo ist kein Einzelprogramm wie ein
*Session Speichern und Beenden reagiert langsam*: Agordejo ist kein Einzelprogramm wie ein
Office-Writer. Die teilnehmenden Programme in der Session sind auch keine Plugins. Wenn Sie die
Session beenden wird ein Signal an alle teilnehmenden Programme gesendet, dass sie speichern
sollen. Das kann ein paar Momente dauern, in denen Sie "live" mitverfolgen, wie die einzelnen
@@ -327,7 +327,7 @@ Programme sich beenden und aus der Session verschwinden. Es ist alles in Ordnung


*Ich habe ein Programm hinzugefügt aber es speichert nicht mit der Session*:
Unterstützt das Programm Session Management? Wenn nicht, kann Argodejo nichts tun.
Unterstützt das Programm Session Management? Wenn nicht, kann Agordejo nichts tun.
Aber Sie können die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir können zusammen an der Unterstützung arbeiten.

@@ -337,14 +337,14 @@ Das tut uns leid. Eigentlich sind die Programme selbst schuld, aber auch wir sin
interessiert die Situation zu verbessen, indem wir in Zukunft zumindest eine Notlösung anbieten.


*Argodejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Argodejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
*Agordejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Agordejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
hätte ein kleines Nachrichtenfenster aufpoppen sollen. Falls in ihrem Window-Manager kein Tray
vorhanden ist sollte das Programm immer sichtbar sein. Bei besonderen Window-Managern (bei der
großen Auswahl in Linux) kann es sein, dass die Tray-Erkennung nicht richtig funktioniert hat.
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/argodejo` zu löschen. Dabei werden KEINE
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/agordejo` zu löschen. Dabei werden KEINE
Sessions gelöscht, sondern nur lokale Einstellungen wie die Sichtbarkeit des Programmfensters. Beim
nächsten Start wird Argodejo sich verhalten wie beim allerersten.
nächsten Start wird Agordejo sich verhalten wie beim allerersten.


*JACK ist abgestürzt. Viele Programme hängen. Was tun um Datenverlust zu vermeiden?*:
@@ -357,7 +357,7 @@ manuell im Dateimanager eine Kopie des Session-Verzeichnisses machen.


*Ein Programmupdate hat meine Session kaputtgemacht, weil es seine Dateien nicht mehr laden kann.*:
Das ist leider ein Problem, dass auch Argodejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
Das ist leider ein Problem, dass auch Agordejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
wie mit alle anderen Software, etwa Officeprogramme. Falls Sie befürchten, dass ein Programm in
Zukunft inkompatibel wird notieren Sie sich dessen Versionsnummer in den Session-Notizen, damit Sie
zumindest zur Not die alte Programmversion wieder installieren können (auch wenn das sehr
@@ -371,7 +371,7 @@ immer.

Sie sollten sich nicht genötigt fühlen plötzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
Argodejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
Agordejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
@@ -390,7 +390,7 @@ aber trotzdem inhaltlich dazu gehört: Open Broadcast Studio (OBS), Musikplayer,
und Grafikprogramme etc.


*Argodejo beinhaltet Funktionalität, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
*Agordejo beinhaltet Funktionalität, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
und Komplexität ist unvermeidlich. Sie ist wie ein Wasserbett: Drückt man die auf der einen Seite
runter, muss etwas an einen anderen Stelle hochdrücken. Macht man ein programm "clean and lean",
und implementiert damit nur einen Teil des kompletten Arbeitsablaufs, dann kommt der fehlende Teil
@@ -401,7 +401,7 @@ ist, und er es tun kann, dann soll er es machen.

Oder Abstürze: Technisch gesehen sind abstürzende Programme nicht das "Problem" des Session
Managers, aber sie sind Teil der Softwarewirklichkeit. Abstürze passieren jeden Tag und nun muss
man damit umgehen. Kann Argodejo die Arbeit vereinfachen und helfen den guten Zustand wieder
man damit umgehen. Kann Agordejo die Arbeit vereinfachen und helfen den guten Zustand wieder
herzustellen? Dann sollte das geschehen.

Session Management ist außerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.
@@ -411,30 +411,30 @@ Sessions über das Netzwerk zu verteilen.

== Installation und Start

Argodejo ist exklusiv für Linux. Am besten installieren Sie Argodejo über deinen Paketmanager.
Agordejo ist exklusiv für Linux. Am besten installieren Sie Agordejo über deinen Paketmanager.
Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitten sie ihre
Linuxdistribution Argodejo bereitzustellen.
Linuxdistribution Agordejo bereitzustellen.

Falls nicht in den Paketquellen vorhanden kann man Argodejo auch selbst "bauen".
Falls nicht in den Paketquellen vorhanden kann man Agordejo auch selbst "bauen".

.Abhängigkeiten*
* Eine Liste der Abhängigkeit befindet sich in der README.md
* Kompilieren und Installieren geht entweder mit einem Releasedownload oder mit der Git-Version:
** Laden Sie von https://www.laborejo.org/downloads die aktuelle Version herunter und entpacken Sie sie.
** `git clone https://git.laborejo.org/lss/argodejo.git`
** `git clone https://git.laborejo.org/lss/agordejo.git`
* Wechseln Sie in das neue Verzeichnis und benutzen diese Befehle:
*`./configure --prefix=/usr`
** Das Standardprefix is /usr/local
* `make`
* `sudo make install`

Nun ist das Programm durch `argodejo` in ihrem Terminal oder Programmstarter vorhanden.
Nun ist das Programm durch `agordejo` in ihrem Terminal oder Programmstarter vorhanden.

In der Datei README.md befinden sich weitere Möglichkeiten argodejo zu starten. Diese sind zum
In der Datei README.md befinden sich weitere Möglichkeiten agordejo zu starten. Diese sind zum
Musikmachen nicht praktikabel, aber nützlich für Tests und Entwicklung.

== Helfen und Entwicklung
Sie können Argodejo auf viele Arten und Weisen helfen: Testen und Fehler melden, übersetzen, marketing,
Sie können Agordejo auf viele Arten und Weisen helfen: Testen und Fehler melden, übersetzen, marketing,
anderen Nutzern helfen und schließlich programmieren.

=== Testen und Programmfehler
@@ -452,7 +452,7 @@ Falls Sie an der Entwicklung interessiert sind, melden Sie sich am besten direkt
Kurzversion: clone git, programmieren, einen git-patch erstellen oder uns eine git URL zukommen lassen.

=== Übersetzungen
Argodejo ist mit Hilfe der Qt-Toolchain sehr einfach zu übersetzen, ohne, dass man dafür Programmieren muss.
Agordejo ist mit Hilfe der Qt-Toolchain sehr einfach zu übersetzen, ohne, dass man dafür Programmieren muss.
Die einfachste Variante ist es einfach die Entwickler anzusprechen und sie werden die neue Sprache einrichten.

Hier ist dennoch die komplette Anleitung, um eine Übersetzung komplett alleine anzufertigen und in
@@ -482,6 +482,6 @@ Python Kentnisse nötig.

Um die neue Übersetzung zu testen starten Sie das Programm, falls ihr System bereits auf diese
Sprache eingstellt ist.
Ansonsten starten Sie argodejo mit diesem Befehl, Sprachcode ändern, vom Terminal aus:
Ansonsten starten Sie agordejo mit diesem Befehl, Sprachcode ändern, vom Terminal aus:

* `LANGUAGE=de_DE.UTF-8 ./argodejo -V`
* `LANGUAGE=de_DE.UTF-8 ./agordejo -V`

+ 30
- 30
documentation/german.part.adoc View File

@@ -21,28 +21,28 @@ Echtzeit teilen, verfügen über synchronisierte Timelines und spielen im gleich

Was übrig bleibt ist die leidige Arbeit jedesmal alle Programme zu starten, die Projektdateien zu
laden, alle Audiokanäle zu verbinden usw. Session Management im allgemeinen (z.B. extra
geschriebene Starter-Scriptdateien) und Argodejo im speziellen nehmen Ihnen diese Arbeit ab, oder
geschriebene Starter-Scriptdateien) und Agordejo im speziellen nehmen Ihnen diese Arbeit ab, oder
vereinfachen sie zumindest stark.

Im Gegensatz zum erwähnten selbstgeschriebenen Script müssen Sie sich nicht im Vorraus für ein
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.


=== Anwendungsbeispiel

* Argodejo starten (Startmenü, Terminal etc.)
* Agordejo starten (Startmenü, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der große Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschließend) dessen grafische Oberfläche
* Sollte das Programm abstürzen bekommt man das signalisiert und kann es neustarten.
* Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Argodejo gespeichert.
* Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.
* Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln
* Der Name der Session ist bisher einfach ein Datum. Durch Klick auf dieses kann man einen richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Knopf "Speichern und Schließen" wieder in die Sessionauswahl zurück
* Nun könnte Argodejo geschlossen werden.
* Nun könnte Agordejo geschlossen werden.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/NSM Sessions/Mein Lied`)
* Die Session kann weitergeführt werden: Nach dem Klick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.

@@ -58,7 +58,7 @@ Entscheidungen wie möglich zu treffen haben und so schnell wie möglich (mit de
eine alte Session starten oder eine neue erstellen können.

Aus Stabilitätsgründen werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Argodejos zusammenarbeiten.
korrekt mit dem Session Management Agordejos zusammenarbeiten.

Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie können jederzeit hin- und herschalten.
@@ -138,7 +138,7 @@ Jede Session verfügt über ein Kontextmenü (z.B. rechte Maustaste) mit weitere
eine Session umbennen, löschen (inkl. aller dazugehörigen Dateien auf der Festplatte!) und mehr.
Diese Funktionen sind gleichwertig zu ihrem Dateimanager. Falls Sie möchten, können Sie auch
einfach die Sessionverzeichnisse selbst umbennen, verschieben oder löschen (sofern diese nicht
gerade geöffnet ist). Dazu muss Argodejo nicht neugestartet werden, es reagiert selbst auf die
gerade geöffnet ist). Dazu muss Agordejo nicht neugestartet werden, es reagiert selbst auf die
Änderungen.

Hier gibt es auch die Möglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
@@ -177,7 +177,7 @@ Pro Programm gibt es folgende Informationen:
* Den Programmstatus (auf Englisch, da es sich um definierte Schlüsselworte handelt).
* Stopped / Gestoppt, läuft nicht
* Ready / Läuft und Bereit
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Argodejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Agordejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
* Weitere Zustände sind nur Übergänge und meist nur sehr kurz zu sehen, z.B. Open / Läd gerade
* Sichtbarkeit (Ein Kreuz für sichtbar, Leer für unsichtbar)
* Änderungen - Gibt es momentan ungespeicherte Änderungen?
@@ -208,13 +208,13 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menüs zur Verfügung, di
* Abbrechen beendet die Session, ohne dass die Programme abspeichern
* Speichern Unter speichert die Session unter einem anderen Namen und schließt die laufende ohne abzuspeichern. Ab nun arbeitet man in der neuen Session.
* Client Hinzufügen bietet die Option ein beliebiges Programm hinzuzufügen, egal ob es in der Programmdatenbank ist, oder nicht.
* Es werden alle installierten Programme vorgeschlagen. Argodejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier `ls` wie auch `argodejo` selbst.
* Es werden alle installierten Programme vorgeschlagen. Agordejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier `ls` wie auch `agordejo` selbst.

== Programm-Datenbank

Argodejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
Agordejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
teilweise von Hand eingepflegt wurde. Das bedeutet nichts anderes, als das alle installieren
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Argodejo-Starter nur
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Agordejo-Starter nur
das angeboten wird, was Sie auch tatsächlich installiert haben.

Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
@@ -222,7 +222,7 @@ Augenblicke bis einige Minuten dauern.

Wenn Sie Audio-Programme neu installieren, oder deinstallieren müssen Sie die Datenbank selbst
aktualisieren. Im Steuerungsmenü gibt es den Befehl. Programminstallationen sind sogar möglich
während Argodejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
während Agordejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
neuen Programme zur Verfügung.

Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@@ -250,10 +250,10 @@ Verzeichnis.

== Tray

Argodejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
Agordejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Agordejo.

Schließt man Argodejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Schließt man Agordejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Programm und die Session nicht beendet, sondern in den Tray minimiert.

Ein Rechtsklick auf das Icon bietet Schnellzugriff auf häufige Funktionen:
@@ -262,7 +262,7 @@ Sie können hier die zuletzt benutzen Sessions direkt starten.

Läuft bereits eine Session können Sie speichern, abbrechen etc.

Argodejo kann hier auch komplett beendet werden.
Agordejo kann hier auch komplett beendet werden.

== Netzwerk-Sessions

@@ -272,25 +272,25 @@ vorgesehen.

== Programmparameter

Als fortgeschrittener Benutzer können Sie Argodejo im Terminal starten und dort einige Parameter
Als fortgeschrittener Benutzer können Sie Agordejo im Terminal starten und dort einige Parameter
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.

Eine Auswahl:

* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte Session
* `--hide` startet Argodejo als Trayicon.
* `--hide` startet Agordejo als Trayicon.
* `--url osc.udp://myhost.localdomain:14294/` verbindet sich zu diesem Server, falls vorhanden, oder startet den internen Session-Server unter dieser Adresse. Dies ist eine sehr technische Option und wird wahrscheinlich nicht benötigt.
* `--session-root /home/benutzer/produktion2020` setzt das Wurzelverzeichnis. Nur Sessions in diesem Verzeichnis werden angezeigt, alles wird dort gespeichert.

Die Kombination von `--continue` und `--hide` ergibt einen Modus, den viele Leute vom Session Management
erwarten: dort weiter machen wo man aufgehört hat, ohne dass Extrafenster angezeigt werden.
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Argodejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.

== Verschiedenes / Erklärungen / FAQ

*Session Speichern und Beenden reagiert langsam*: Argodejo ist kein Einzelprogramm wie ein
*Session Speichern und Beenden reagiert langsam*: Agordejo ist kein Einzelprogramm wie ein
Office-Writer. Die teilnehmenden Programme in der Session sind auch keine Plugins. Wenn Sie die
Session beenden wird ein Signal an alle teilnehmenden Programme gesendet, dass sie speichern
sollen. Das kann ein paar Momente dauern, in denen Sie "live" mitverfolgen, wie die einzelnen
@@ -298,7 +298,7 @@ Programme sich beenden und aus der Session verschwinden. Es ist alles in Ordnung


*Ich habe ein Programm hinzugefügt aber es speichert nicht mit der Session*:
Unterstützt das Programm Session Management? Wenn nicht, kann Argodejo nichts tun.
Unterstützt das Programm Session Management? Wenn nicht, kann Agordejo nichts tun.
Aber Sie können die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir können zusammen an der Unterstützung arbeiten.

@@ -308,14 +308,14 @@ Das tut uns leid. Eigentlich sind die Programme selbst schuld, aber auch wir sin
interessiert die Situation zu verbessen, indem wir in Zukunft zumindest eine Notlösung anbieten.


*Argodejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Argodejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
*Agordejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Agordejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
hätte ein kleines Nachrichtenfenster aufpoppen sollen. Falls in ihrem Window-Manager kein Tray
vorhanden ist sollte das Programm immer sichtbar sein. Bei besonderen Window-Managern (bei der
großen Auswahl in Linux) kann es sein, dass die Tray-Erkennung nicht richtig funktioniert hat.
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/argodejo` zu löschen. Dabei werden KEINE
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/agordejo` zu löschen. Dabei werden KEINE
Sessions gelöscht, sondern nur lokale Einstellungen wie die Sichtbarkeit des Programmfensters. Beim
nächsten Start wird Argodejo sich verhalten wie beim allerersten.
nächsten Start wird Agordejo sich verhalten wie beim allerersten.


*JACK ist abgestürzt. Viele Programme hängen. Was tun um Datenverlust zu vermeiden?*:
@@ -328,7 +328,7 @@ manuell im Dateimanager eine Kopie des Session-Verzeichnisses machen.


*Ein Programmupdate hat meine Session kaputtgemacht, weil es seine Dateien nicht mehr laden kann.*:
Das ist leider ein Problem, dass auch Argodejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
Das ist leider ein Problem, dass auch Agordejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
wie mit alle anderen Software, etwa Officeprogramme. Falls Sie befürchten, dass ein Programm in
Zukunft inkompatibel wird notieren Sie sich dessen Versionsnummer in den Session-Notizen, damit Sie
zumindest zur Not die alte Programmversion wieder installieren können (auch wenn das sehr
@@ -342,7 +342,7 @@ immer.

Sie sollten sich nicht genötigt fühlen plötzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
Argodejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
Agordejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
@@ -361,7 +361,7 @@ aber trotzdem inhaltlich dazu gehört: Open Broadcast Studio (OBS), Musikplayer,
und Grafikprogramme etc.


*Argodejo beinhaltet Funktionalität, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
*Agordejo beinhaltet Funktionalität, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
und Komplexität ist unvermeidlich. Sie ist wie ein Wasserbett: Drückt man die auf der einen Seite
runter, muss etwas an einen anderen Stelle hochdrücken. Macht man ein programm "clean and lean",
und implementiert damit nur einen Teil des kompletten Arbeitsablaufs, dann kommt der fehlende Teil
@@ -372,7 +372,7 @@ ist, und er es tun kann, dann soll er es machen.

Oder Abstürze: Technisch gesehen sind abstürzende Programme nicht das "Problem" des Session
Managers, aber sie sind Teil der Softwarewirklichkeit. Abstürze passieren jeden Tag und nun muss
man damit umgehen. Kann Argodejo die Arbeit vereinfachen und helfen den guten Zustand wieder
man damit umgehen. Kann Agordejo die Arbeit vereinfachen und helfen den guten Zustand wieder
herzustellen? Dann sollte das geschehen.

Session Management ist außerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.

+ 1
- 1
documentation/index.adoc View File

@@ -18,7 +18,7 @@ https://asciidoctor.org/docs/user-manual/
:nofooter:


== Argodejo Multi-Language Documentation
== Agordejo Multi-Language Documentation
image::logo.png["logo", 320, 180]

For program version 0.1

+ 9
- 9
documentation/manpageinclude.h2m View File

@@ -1,10 +1,10 @@

[name]
Argodejo - Music and audio production session manager based on NSM.
Agordejo - Music and audio production session manager based on NSM.

[usage]

Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.

@@ -13,7 +13,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.


Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.


@@ -23,7 +23,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.


That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.


@@ -31,18 +31,18 @@ should provide a good user experience.
https://www.laborejo.org/bugs

[copyright]
Argodejo 0.1 - Copyright 2020
Agordejo 0.1 - Copyright 2020
Laborejo Software Suite
https://www.laborejo.org/

[examples]
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.

[see also]
The full documentation for Argodejo is maintained as a multi-lingual html site to your systems doc-dir.
The full documentation for Agordejo is maintained as a multi-lingual html site to your systems doc-dir.
For example:
xdg-open file:///usr/share/doc/argodejo/index.html
xdg-open file:///usr/share/doc/agordejo/index.html

The documentation can also be found online https://www.laborejo.org/documentation/argodejo
The documentation can also be found online https://www.laborejo.org/documentation/agordejo

+ 1
- 1
documentation/nsm-data.1 View File

@@ -5,7 +5,7 @@ nsm-data \- manual page for nsm-data 1.0
.SH DESCRIPTION
usage: nsm\-data [\-h] [\-v]
.PP
nsm\-data is a module for Argodejo. It only communicates over OSC in an NSMSession and has no standalone functionality.
nsm\-data is a module for Agordejo. It only communicates over OSC in an NSMSession and has no standalone functionality.
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR

+ 45
- 45
documentation/out/english.html View File

@@ -6,7 +6,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 2.0.10">
<meta name="author" content="Laborejo Software Suite">
<title>Argodejo</title>
<title>Agordejo</title>
<style>
/* Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
/* Uncomment @import statement to use as custom stylesheet */
@@ -438,7 +438,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
</head>
<body class="article toc2 toc-left">
<div id="header">
<h1>Argodejo</h1>
<h1>Agordejo</h1>
<div class="details">
<span id="author" class="author">Laborejo Software Suite</span><br>
</div>
@@ -500,7 +500,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<h2 id="_introduction">1. Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo (Esperanto: 'place to set things up') is a music production session manager.
<p>Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.</p>
</div>
@@ -509,7 +509,7 @@ in general.</p>
control and a detailed overview.</p>
</div>
<div class="paragraph">
<p>Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
<p>Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.</p>
</div>
<div class="paragraph">
@@ -519,7 +519,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.</p>
</div>
<div class="paragraph">
<p>That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
<p>That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.</p>
</div>
</div>
@@ -552,18 +552,18 @@ real time, have synchronized timelines and play in the same tempo.</p>
<div class="paragraph">
<p>What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.</p>
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.</p>
</div>
<div class="paragraph">
<p>In contrast to the self-written script mentioned above, you don&#8217;t have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.</p>
setup, but everything is saved automatically as long as you manage everything through Agordejo.</p>
</div>
<div class="sect2">
<h3 id="_example">2.1. Example</h3>
<div class="ulist">
<ul>
<li>
<p>Start Argodejo (Start menu, terminal etc.)</p>
<p>Start Agordejo (Start menu, terminal etc.)</p>
</li>
<li>
<p>You are now in the "Quick View" to start a session</p>
@@ -584,7 +584,7 @@ setup, but everything is saved automatically as long as you manage everything th
<p>If the program crashes you get a warning and can restart it.</p>
</li>
<li>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.</p>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.</p>
</li>
<li>
<p>To get more programs and advanced features you can switch to the tab "Full View</p>
@@ -596,7 +596,7 @@ setup, but everything is saved automatically as long as you manage everything th
<p>If you are finished you can return to the session selection by pressing the button "Save and Close"</p>
</li>
<li>
<p>Now Argodejo could be closed itself.</p>
<p>Now Agordejo could be closed itself.</p>
</li>
<li>
<p>All stored data is in a single directory on the hard disk (<code>~/NSM Sessions/My Song</code>)</p>
@@ -623,7 +623,7 @@ at least clicks).</p>
</div>
<div class="paragraph">
<p>For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.</p>
work correctly with Agordejos session management.</p>
</div>
<div class="paragraph">
<p>The Quick View is only a view. There is no technical difference to the full view and you can switch
@@ -720,11 +720,11 @@ just a view, your data remains untouched.</p>
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don&#8217;t need to restart Argodejo to do this, it will respond to the changes while running.</p>
don&#8217;t need to restart Agordejo to do this, it will respond to the changes while running.</p>
</div>
<div class="paragraph">
<p>There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@@ -778,7 +778,7 @@ to hide its window if the program supports it. If not, nothing happens.</p>
<p>Ready, running</p>
</li>
<li>
<p>Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)</p>
<p>Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)</p>
</li>
<li>
<p>Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading</p>
@@ -844,7 +844,7 @@ lyrics, credits and sources from external Samples etc.</p>
<p>Add Client offers the option to add any program, whether it is in the program database or not.</p>
</li>
<li>
<p>Any installed programs are suggested. Argodejo doesn&#8217;t check them for usefulness for a music session, or even for runnability. You will find <code>ls</code> here as well as <code>argodejo</code> itself.</p>
<p>Any installed programs are suggested. Agordejo doesn&#8217;t check them for usefulness for a music session, or even for runnability. You will find <code>ls</code> here as well as <code>agordejo</code> itself.</p>
</li>
</ul>
</div>
@@ -856,8 +856,8 @@ lyrics, credits and sources from external Samples etc.</p>
<h2 id="_program_database">5. Program-Database</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
<p>Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.</p>
</div>
<div class="paragraph">
@@ -867,7 +867,7 @@ a few minutes.</p>
<div class="paragraph">
<p>If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.</p>
</div>
<div class="paragraph">
@@ -902,11 +902,11 @@ search paths. One absolute directory path per line, no wildcards, trailing slash
<h2 id="_tray">6. Tray</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.</p>
<p>Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.</p>
</div>
<div class="paragraph">
<p>If you close Argodejo using the normal window manager function, such as a click on the [X], the
<p>If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.</p>
</div>
<div class="paragraph">
@@ -919,7 +919,7 @@ program and the session is not terminated, but minimized to the tray.</p>
<p>If a session is already running you can save, cancel etc.</p>
</div>
<div class="paragraph">
<p>Argodejo can also be completely exited here.</p>
<p>Agordejo can also be completely exited here.</p>
</div>
</div>
</div>
@@ -936,7 +936,7 @@ version.</p>
<h2 id="_program_parameters">8. Program parameters</h2>
<div class="sectionbody">
<div class="paragraph">
<p>As an advanced user, you can start Argodejo in the terminal and add some parameters.. For a
<p>As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
complete list please use the --help parameter.</p>
</div>
<div class="paragraph">
@@ -951,7 +951,7 @@ complete list please use the --help parameter.</p>
<p><code>--continue</code> starts the last active session.</p>
</li>
<li>
<p><code>--hide</code> starts Argodejo as TrayIcon.</p>
<p><code>--hide</code> starts Agordejo as TrayIcon.</p>
</li>
<li>
<p><code>--url osc.udp://myhost.localdomain:14294/</code> connects to this server, if available, or starts the internal session server at this address. This is a very technical option and probably not needed.</p>
@@ -964,8 +964,8 @@ complete list please use the --help parameter.</p>
<div class="paragraph">
<p>The combination of <code>--continue</code> and <code>--hide</code> is essentially what many people expect from Session
Management: Resuming at the previous state, without any extra windows in their way.
If your system uses a start menu you will find not only the normal Argodejo starter but also
"Argodejo Continue" to start this mode directly.</p>
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Agordejo Continue" to start this mode directly.</p>
</div>
</div>
</div>
@@ -973,7 +973,7 @@ If your system uses a start menu you will find not only the normal Argodejo star
<h2 id="_miscellaneous_explanations_faq">9. Miscellaneous / Explanations / FAQ</h2>
<div class="sectionbody">
<div class="paragraph">
<p><strong>Session Save and Exit responds slowly</strong>: Argodejo is not a standalone program like an word
<p><strong>Session Save and Exit responds slowly</strong>: Agordejo is not a standalone program like an word
processor. The participating programs in the session are not plugins either. When you end the
session a signal is sent to all participating client to save. This may take a few moments where
you are able to see "live" how individual programs terminate and disappear from the session.
@@ -981,7 +981,7 @@ Everything is fine.</p>
</div>
<div class="paragraph">
<p><strong>I have added a program but it does not save with the session</strong>: Does the program support session
management? If not, Argodejo cannot do much. But you can ask the program developers to contact us
management? If not, Agordejo cannot do much. But you can ask the program developers to contact us
(<a href="mailto:info@laborejo.org">info@laborejo.org</a>) and we can work together on support.</p>
</div>
<div class="paragraph">
@@ -990,13 +990,13 @@ we are also interested in improving the situation by offering at least an emerge
future.</p>
</div>
<div class="paragraph">
<p><strong>Argodejo won&#8217;t start! I start the program but I can&#8217;t see anything</strong>: Most likely Argodejo is
<p><strong>Agordejo won&#8217;t start! I start the program but I can&#8217;t see anything</strong>: Most likely Agordejo is
running, but invisible, because you exited it from the tray last time. Is it in the tray? A
message should have popped up, maybe you missed it. If there is no tray in your window manager, the
program should always be visible. With all these special window managers in Linux it may be that
the tray detection did not work properly. Contingency plan is to delete
<code>~/.config/LaborejoSoftwareSuite/argodejo</code>. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Argodejo will behave like the
<code>~/.config/LaborejoSoftwareSuite/agordejo</code>. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.</p>
</div>
<div class="paragraph">
@@ -1010,7 +1010,7 @@ inevitable crashes).</p>
</div>
<div class="paragraph">
<p><strong>A program update broke my session because it can no longer load its files.</strong> Unfortunately, this is
a problem that even Argodejo can&#8217;t solve. It also happens with LV2 plugins and with all other
a problem that even Agordejo can&#8217;t solve. It also happens with LV2 plugins and with all other
software, such as office programs. If you fear that a program becomes incompatible in the future,
write down its version number in the session notes, so that you can at least, in an emergency,
reinstall the old program version (even if this is very is cumbersome).</p>
@@ -1021,7 +1021,7 @@ management is worthwhile with two or more participating programs, which one need
</div>
<div class="paragraph">
<p>You should not feel compelled to suddenly make everything modular with individual programs, only
because you use a session manager. Argodejo is designed to make your music production easier. If it
because you use a session manager. Agordejo is designed to make your music production easier. If it
is faster and more comfortable to manage all plugins and effects e.g. in a single "Carla" instance
then you should do exactly that. If you basically want to do everything in Ardour, do that, but
start Ardour anyway in session management, because no program can do everything alone and the time
@@ -1040,7 +1040,7 @@ directly do music production, but still is connected in the grander scheme: Ope
(OBS), music player, word processors and graphic programs etc.</p>
</div>
<div class="paragraph">
<p><strong>Argodejo contains functionality which is not within its scope</strong>: Music production is very complex
<p><strong>Agordejo contains functionality which is not within its scope</strong>: Music production is very complex
and complexity is inevitable. It&#8217;s like a waterbed: if you press down on one side, something
bounces up in another place. When you create a "clean and lean" program, which therefore implements
only a part of the complete workflow, then the missing part pops up somewhere else. A minimalistic
@@ -1050,7 +1050,7 @@ session manager provokes plug-ins (not LV2), helper-scripts, workarounds and hac
<p>E.g. not to include file management provokes user errors like deleting the wrong files. If the SM
knows what to do and it can do it, then let it do it. Or crashes: Technically, crashing programs
are not the "problem" of the session managers, but they are part of the software reality. Crashes
happen every day and need to be handled. Can Argodejo simplify the work and help to restore good
happen every day and need to be handled. Can Agordejo simplify the work and help to restore good
conditions again? Then that should be done. Session management is also an opportunity to simplify
even complex technical scenarios, e.g. distributing sessions over the network.</p>
</div>
@@ -1060,11 +1060,11 @@ even complex technical scenarios, e.g. distributing sessions over the network.</
<h2 id="_installation_and_start">10. Installation and Start</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo is exclusive for Linux. The best way to install is to use your package manager.
<p>Agordejo is exclusive for Linux. The best way to install is to use your package manager.
If it is not there, or only in an outdated version, please ask your Linux distribution to provide a recent version.</p>
</div>
<div class="paragraph">
<p>If not available in the package repository you can build Argodejo yourself.</p>
<p>If not available in the package repository you can build Agordejo yourself.</p>
</div>
<div class="ulist">
<div class="title">Build and Install</div>
@@ -1080,7 +1080,7 @@ If it is not there, or only in an outdated version, please ask your Linux distri
<p>Download the latest version from <a href="https://www.laborejo.org/downloads" class="bare">https://www.laborejo.org/downloads</a> and extract it.</p>
</li>
<li>
<p>git clone <a href="https://git.laborejo.org/lss/argodejo.git" class="bare">https://git.laborejo.org/lss/argodejo.git</a></p>
<p>git clone <a href="https://git.laborejo.org/lss/agordejo.git" class="bare">https://git.laborejo.org/lss/agordejo.git</a></p>
</li>
</ul>
</div>
@@ -1107,10 +1107,10 @@ If it is not there, or only in an outdated version, please ask your Linux distri
</ul>
</div>
<div class="paragraph">
<p>Now the program is available to run via your menu/launcher or <code>argodejo</code> in a terminal.</p>
<p>Now the program is available to run via your menu/launcher or <code>agordejo</code> in a terminal.</p>
</div>
<div class="paragraph">
<p>Please read README.md for other ways of starting argodejo, which are impractical for actual use but can
<p>Please read README.md for other ways of starting agordejo, which are impractical for actual use but can
be helpful for testing and development.</p>
</div>
</div>
@@ -1119,7 +1119,7 @@ be helpful for testing and development.</p>
<h2 id="_help_and_development">11. Help and Development</h2>
<div class="sectionbody">
<div class="paragraph">
<p>You can help Argodejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.</p>
<p>You can help Agordejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.</p>
</div>
<div class="sect2">
<h3 id="_testing_and_reporting_errors">11.1. Testing and Reporting Errors</h3>
@@ -1155,7 +1155,7 @@ The short version is: clone the git, change the code, create a git patch or poin
<div class="sect2">
<h3 id="_translations">11.3. Translations</h3>
<div class="paragraph">
<p>Argodejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
<p>Agordejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
The easiest way is to contact the developers and they will setup the new language.</p>
</div>
<div class="paragraph">
@@ -1204,7 +1204,7 @@ The easiest way is to contact the developers and they will setup the new languag
</ul>
</div>
<div class="paragraph">
<p>You can also incorporate the translation into Argodejo for testing purposes. This requires rudimentary Python knowledge.</p>
<p>You can also incorporate the translation into Agordejo for testing purposes. This requires rudimentary Python knowledge.</p>
</div>
<div class="ulist">
<ul>
@@ -1233,12 +1233,12 @@ The easiest way is to contact the developers and they will setup the new languag
</ul>
</div>
<div class="paragraph">
<p>To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start argodejo via the terminal:</p>
<p>To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start agordejo via the terminal:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>LANGUAGE=de_DE.UTF-8 ./argodejo -V --save /dev/null</code></p>
<p><code>LANGUAGE=de_DE.UTF-8 ./agordejo -V --save /dev/null</code></p>
</li>
</ul>
</div>

+ 42
- 42
documentation/out/german.html View File

@@ -6,7 +6,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 2.0.10">
<meta name="author" content="Laborejo Software Suite">
<title>Argodejo</title>
<title>Agordejo</title>
<style>
/* Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
/* Uncomment @import statement to use as custom stylesheet */
@@ -438,7 +438,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
</head>
<body class="article toc2 toc-left">
<div id="header">
<h1>Argodejo</h1>
<h1>Agordejo</h1>
<div class="details">
<span id="author" class="author">Laborejo Software Suite</span><br>
</div>
@@ -528,20 +528,20 @@ Echtzeit teilen, verfügen über synchronisierte Timelines und spielen im gleich
<div class="paragraph">
<p>Was übrig bleibt ist die leidige Arbeit jedesmal alle Programme zu starten, die Projektdateien zu
laden, alle Audiokanäle zu verbinden usw. Session Management im allgemeinen (z.B. extra
geschriebene Starter-Scriptdateien) und Argodejo im speziellen nehmen Ihnen diese Arbeit ab, oder
geschriebene Starter-Scriptdateien) und Agordejo im speziellen nehmen Ihnen diese Arbeit ab, oder
vereinfachen sie zumindest stark.</p>
</div>
<div class="paragraph">
<p>Im Gegensatz zum erwähnten selbstgeschriebenen Script müssen Sie sich nicht im Vorraus für ein
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.</p>
Manager Agordejo starten.</p>
</div>
<div class="sect2">
<h3 id="_anwendungsbeispiel">1.1. Anwendungsbeispiel</h3>
<div class="ulist">
<ul>
<li>
<p>Argodejo starten (Startmenü, Terminal etc.)</p>
<p>Agordejo starten (Startmenü, Terminal etc.)</p>
</li>
<li>
<p>Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten</p>
@@ -562,7 +562,7 @@ Manager Argodejo starten.</p>
<p>Sollte das Programm abstürzen bekommt man das signalisiert und kann es neustarten.</p>
</li>
<li>
<p>Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Argodejo gespeichert.</p>
<p>Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.</p>
</li>
<li>
<p>Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln</p>
@@ -574,7 +574,7 @@ Manager Argodejo starten.</p>
<p>Ist man soweit fertig kommt man durch den Knopf "Speichern und Schließen" wieder in die Sessionauswahl zurück</p>
</li>
<li>
<p>Nun könnte Argodejo geschlossen werden.</p>
<p>Nun könnte Agordejo geschlossen werden.</p>
</li>
<li>
<p>Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (<code>~/NSM Sessions/Mein Lied</code>)</p>
@@ -602,7 +602,7 @@ eine alte Session starten oder eine neue erstellen können.</p>
</div>
<div class="paragraph">
<p>Aus Stabilitätsgründen werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Argodejos zusammenarbeiten.</p>
korrekt mit dem Session Management Agordejos zusammenarbeiten.</p>
</div>
<div class="paragraph">
<p>Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
@@ -702,7 +702,7 @@ sortieren zu können. Das ist nur eine Ansicht, ihre Daten bleiben unangetastet.
eine Session umbennen, löschen (inkl. aller dazugehörigen Dateien auf der Festplatte!) und mehr.
Diese Funktionen sind gleichwertig zu ihrem Dateimanager. Falls Sie möchten, können Sie auch
einfach die Sessionverzeichnisse selbst umbennen, verschieben oder löschen (sofern diese nicht
gerade geöffnet ist). Dazu muss Argodejo nicht neugestartet werden, es reagiert selbst auf die
gerade geöffnet ist). Dazu muss Agordejo nicht neugestartet werden, es reagiert selbst auf die
Änderungen.</p>
</div>
<div class="paragraph">
@@ -762,7 +762,7 @@ um, sofern das Programm unterstüzt sein Fenster zu verstecken. Falls nicht pass
<p>Ready / Läuft und Bereit</p>
</li>
<li>
<p>Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Argodejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)</p>
<p>Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstützt. Agordejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)</p>
</li>
<li>
<p>Weitere Zustände sind nur Übergänge und meist nur sehr kurz zu sehen, z.B. Open / Läd gerade</p>
@@ -830,7 +830,7 @@ Samples etc.</p>
<p>Client Hinzufügen bietet die Option ein beliebiges Programm hinzuzufügen, egal ob es in der Programmdatenbank ist, oder nicht.</p>
</li>
<li>
<p>Es werden alle installierten Programme vorgeschlagen. Argodejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier <code>ls</code> wie auch <code>argodejo</code> selbst.</p>
<p>Es werden alle installierten Programme vorgeschlagen. Agordejo überprüft diese nicht auf Sinnhaftigkeit für eine Musik-Session, oder auch nur auf Lauffähigkeit. Sie finden hier <code>ls</code> wie auch <code>agordejo</code> selbst.</p>
</li>
</ul>
</div>
@@ -842,9 +842,9 @@ Samples etc.</p>
<h2 id="_programm_datenbank">4. Programm-Datenbank</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
<p>Agordejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
teilweise von Hand eingepflegt wurde. Das bedeutet nichts anderes, als das alle installieren
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Argodejo-Starter nur
Programme in ihrem System überprüft werden (wie ein Startmenü) und Ihnen im Agordejo-Starter nur
das angeboten wird, was Sie auch tatsächlich installiert haben.</p>
</div>
<div class="paragraph">
@@ -854,7 +854,7 @@ Augenblicke bis einige Minuten dauern.</p>
<div class="paragraph">
<p>Wenn Sie Audio-Programme neu installieren, oder deinstallieren müssen Sie die Datenbank selbst
aktualisieren. Im Steuerungsmenü gibt es den Befehl. Programminstallationen sind sogar möglich
während Argodejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
während Agordejo läuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
neuen Programme zur Verfügung.</p>
</div>
<div class="paragraph">
@@ -893,11 +893,11 @@ Verzeichnis.</p>
<h2 id="_tray">5. Tray</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.</p>
<p>Agordejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Agordejo.</p>
</div>
<div class="paragraph">
<p>Schließt man Argodejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
<p>Schließt man Agordejo über die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Programm und die Session nicht beendet, sondern in den Tray minimiert.</p>
</div>
<div class="paragraph">
@@ -910,7 +910,7 @@ Programm und die Session nicht beendet, sondern in den Tray minimiert.</p>
<p>Läuft bereits eine Session können Sie speichern, abbrechen etc.</p>
</div>
<div class="paragraph">
<p>Argodejo kann hier auch komplett beendet werden.</p>
<p>Agordejo kann hier auch komplett beendet werden.</p>
</div>
</div>
</div>
@@ -927,7 +927,7 @@ vorgesehen.</p>
<h2 id="_programmparameter">7. Programmparameter</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Als fortgeschrittener Benutzer können Sie Argodejo im Terminal starten und dort einige Parameter
<p>Als fortgeschrittener Benutzer können Sie Agordejo im Terminal starten und dort einige Parameter
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.</p>
</div>
<div class="paragraph">
@@ -942,7 +942,7 @@ angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.<
<p><code>--continue</code> startet die zuletzt benutzte Session</p>
</li>
<li>
<p><code>--hide</code> startet Argodejo als Trayicon.</p>
<p><code>--hide</code> startet Agordejo als Trayicon.</p>
</li>
<li>
<p><code>--url osc.udp://myhost.localdomain:14294/</code> verbindet sich zu diesem Server, falls vorhanden, oder startet den internen Session-Server unter dieser Adresse. Dies ist eine sehr technische Option und wird wahrscheinlich nicht benötigt.</p>
@@ -955,8 +955,8 @@ angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.<
<div class="paragraph">
<p>Die Kombination von <code>--continue</code> und <code>--hide</code> ergibt einen Modus, den viele Leute vom Session Management
erwarten: dort weiter machen wo man aufgehört hat, ohne dass Extrafenster angezeigt werden.
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Argodejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.</p>
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.</p>
</div>
</div>
</div>
@@ -964,7 +964,7 @@ auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.</p>
<h2 id="_verschiedenes_erklärungen_faq">8. Verschiedenes / Erklärungen / FAQ</h2>
<div class="sectionbody">
<div class="paragraph">
<p><strong>Session Speichern und Beenden reagiert langsam</strong>: Argodejo ist kein Einzelprogramm wie ein
<p><strong>Session Speichern und Beenden reagiert langsam</strong>: Agordejo ist kein Einzelprogramm wie ein
Office-Writer. Die teilnehmenden Programme in der Session sind auch keine Plugins. Wenn Sie die
Session beenden wird ein Signal an alle teilnehmenden Programme gesendet, dass sie speichern
sollen. Das kann ein paar Momente dauern, in denen Sie "live" mitverfolgen, wie die einzelnen
@@ -972,7 +972,7 @@ Programme sich beenden und aus der Session verschwinden. Es ist alles in Ordnung
</div>
<div class="paragraph">
<p><strong>Ich habe ein Programm hinzugefügt aber es speichert nicht mit der Session</strong>:
Unterstützt das Programm Session Management? Wenn nicht, kann Argodejo nichts tun.
Unterstützt das Programm Session Management? Wenn nicht, kann Agordejo nichts tun.
Aber Sie können die Programmentwickler bitten mit uns Kontakt aufzunehmen (<a href="mailto:info@laborejo.org">info@laborejo.org</a>)
und wir können zusammen an der Unterstützung arbeiten.</p>
</div>
@@ -982,14 +982,14 @@ Das tut uns leid. Eigentlich sind die Programme selbst schuld, aber auch wir sin
interessiert die Situation zu verbessen, indem wir in Zukunft zumindest eine Notlösung anbieten.</p>
</div>
<div class="paragraph">
<p><strong>Argodejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.</strong>: Wahrscheinlich ist
Argodejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
<p><strong>Agordejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.</strong>: Wahrscheinlich ist
Agordejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
hätte ein kleines Nachrichtenfenster aufpoppen sollen. Falls in ihrem Window-Manager kein Tray
vorhanden ist sollte das Programm immer sichtbar sein. Bei besonderen Window-Managern (bei der
großen Auswahl in Linux) kann es sein, dass die Tray-Erkennung nicht richtig funktioniert hat.
Notfallplan ist es <code>~/.config/LaborejoSoftwareSuite/argodejo</code> zu löschen. Dabei werden KEINE
Notfallplan ist es <code>~/.config/LaborejoSoftwareSuite/agordejo</code> zu löschen. Dabei werden KEINE
Sessions gelöscht, sondern nur lokale Einstellungen wie die Sichtbarkeit des Programmfensters. Beim
nächsten Start wird Argodejo sich verhalten wie beim allerersten.</p>
nächsten Start wird Agordejo sich verhalten wie beim allerersten.</p>
</div>
<div class="paragraph">
<p><strong>JACK ist abgestürzt. Viele Programme hängen. Was tun um Datenverlust zu vermeiden?</strong>:
@@ -1002,7 +1002,7 @@ manuell im Dateimanager eine Kopie des Session-Verzeichnisses machen.</p>
</div>
<div class="paragraph">
<p><strong>Ein Programmupdate hat meine Session kaputtgemacht, weil es seine Dateien nicht mehr laden kann.</strong>:
Das ist leider ein Problem, dass auch Argodejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
Das ist leider ein Problem, dass auch Agordejo nicht lösen kann. Es passiert mit LV2-Plugins ebenso
wie mit alle anderen Software, etwa Officeprogramme. Falls Sie befürchten, dass ein Programm in
Zukunft inkompatibel wird notieren Sie sich dessen Versionsnummer in den Session-Notizen, damit Sie
zumindest zur Not die alte Programmversion wieder installieren können (auch wenn das sehr
@@ -1017,7 +1017,7 @@ immer.</p>
<div class="paragraph">
<p>Sie sollten sich nicht genötigt fühlen plötzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
Argodejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
Agordejo ist dafür da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
@@ -1038,7 +1038,7 @@ aber trotzdem inhaltlich dazu gehört: Open Broadcast Studio (OBS), Musikplayer,
und Grafikprogramme etc.</p>
</div>
<div class="paragraph">
<p><strong>Argodejo beinhaltet Funktionalität, die nicht seine Aufgabe ist</strong>: Musikproduktion ist sehr komplex
<p><strong>Agordejo beinhaltet Funktionalität, die nicht seine Aufgabe ist</strong>: Musikproduktion ist sehr komplex
und Komplexität ist unvermeidlich. Sie ist wie ein Wasserbett: Drückt man die auf der einen Seite
runter, muss etwas an einen anderen Stelle hochdrücken. Macht man ein programm "clean and lean",
und implementiert damit nur einen Teil des kompletten Arbeitsablaufs, dann kommt der fehlende Teil
@@ -1050,7 +1050,7 @@ ist, und er es tun kann, dann soll er es machen.</p>
<div class="paragraph">
<p>Oder Abstürze: Technisch gesehen sind abstürzende Programme nicht das "Problem" des Session
Managers, aber sie sind Teil der Softwarewirklichkeit. Abstürze passieren jeden Tag und nun muss
man damit umgehen. Kann Argodejo die Arbeit vereinfachen und helfen den guten Zustand wieder
man damit umgehen. Kann Agordejo die Arbeit vereinfachen und helfen den guten Zustand wieder
herzustellen? Dann sollte das geschehen.</p>
</div>
<div class="paragraph">
@@ -1063,12 +1063,12 @@ Sessions über das Netzwerk zu verteilen.</p>
<h2 id="_installation_und_start">9. Installation und Start</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo ist exklusiv für Linux. Am besten installieren Sie Argodejo über deinen Paketmanager.
<p>Agordejo ist exklusiv für Linux. Am besten installieren Sie Agordejo über deinen Paketmanager.
Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitten sie ihre
Linuxdistribution Argodejo bereitzustellen.</p>
Linuxdistribution Agordejo bereitzustellen.</p>
</div>
<div class="paragraph">
<p>Falls nicht in den Paketquellen vorhanden kann man Argodejo auch selbst "bauen".</p>
<p>Falls nicht in den Paketquellen vorhanden kann man Agordejo auch selbst "bauen".</p>
</div>
<div class="ulist">
<div class="title">Abhängigkeiten*</div>
@@ -1084,7 +1084,7 @@ Linuxdistribution Argodejo bereitzustellen.</p>
<p>Laden Sie von <a href="https://www.laborejo.org/downloads" class="bare">https://www.laborejo.org/downloads</a> die aktuelle Version herunter und entpacken Sie sie.</p>
</li>
<li>
<p><code>git clone <a href="https://git.laborejo.org/lss/argodejo.git" class="bare">https://git.laborejo.org/lss/argodejo.git</a></code></p>
<p><code>git clone <a href="https://git.laborejo.org/lss/agordejo.git" class="bare">https://git.laborejo.org/lss/agordejo.git</a></code></p>
</li>
</ul>
</div>
@@ -1109,10 +1109,10 @@ Linuxdistribution Argodejo bereitzustellen.</p>
</ul>
</div>
<div class="paragraph">
<p>Nun ist das Programm durch <code>argodejo</code> in ihrem Terminal oder Programmstarter vorhanden.</p>
<p>Nun ist das Programm durch <code>agordejo</code> in ihrem Terminal oder Programmstarter vorhanden.</p>
</div>
<div class="paragraph">
<p>In der Datei README.md befinden sich weitere Möglichkeiten argodejo zu starten. Diese sind zum
<p>In der Datei README.md befinden sich weitere Möglichkeiten agordejo zu starten. Diese sind zum
Musikmachen nicht praktikabel, aber nützlich für Tests und Entwicklung.</p>
</div>
</div>
@@ -1121,7 +1121,7 @@ Musikmachen nicht praktikabel, aber nützlich für Tests und Entwicklung.</p>
<h2 id="_