// Don't write in the empty line above line. It will be interpreted as author html tag
// Don't write in the empty line above line. It will be interpreted as author html tag
For program version 0.1
For program version 0.1
@ -30,7 +30,7 @@ For program version 0.1
== Introduction
== 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
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.
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.
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.
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.
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.
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
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)
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
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
=== Example
* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Press the big button "Start New Session"
* Now you get a choice of programs:
* Now you get a choice of programs:
* A single click with the mouse starts a program
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* 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
* 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"
* 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"
* 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`)
* 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.
* 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).
at least clicks).
For stability reasons, only programs are shown that are known to
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
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.
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
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
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
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
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
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
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
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
* The program status
* Stopped , not running
* Stopped , not running
* Ready, 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
* 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)
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
* 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
* 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.
* 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.
* 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
== Program-Database
Argodejos launcher is based on a program database, which is partly self-generated, partly
Agordejos 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
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.
installed on your system.
The database is created at the first start. Depending on your system, this can take some moments to
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
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
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.
programs.
If you do not see an installed program in our launcher, but you are sure that it supports session
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
== Tray
Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
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.
program and the session is not terminated, but minimized to the tray.
A right click on the icon gives you access to common functions:
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.
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
== Network Sessions
@ -310,26 +310,26 @@ version.
== Program parameters
== 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.
complete list please use the --help parameter.
For example:
For example:
* `--session newAlbum/mySong` starts the given session.
* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active 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.
* `--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.
* `--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
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.
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
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Argodejo Continue" to start this mode directly.
"Agordejo Continue" to start this mode directly.
== Miscellaneous / Explanations / FAQ
== 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
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
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.
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
*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.
(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.
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
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
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
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
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
`~/.config/LaborejoSoftwareSuite/agordejo`. 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
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.
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 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,
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,
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).
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.
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
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
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
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
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.
(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
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
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
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
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
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
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
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.
even complex technical scenarios, e.g. distributing sessions over the network.
== Installation and Start
== 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 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
.Build and Install
* Please check the supplied README.md for dependencies.
* Please check the supplied README.md for dependencies.
* You can download a release or clone the git version
* You can download a release or clone the git version
** Download the latest version from https://www.laborejo.org/downloads and extract it.
** Download the latest version from https://www.laborejo.org/downloads and extract it.
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:
@ -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
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)
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
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
=== Example
* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Press the big button "Start New Session"
* Now you get a choice of programs:
* Now you get a choice of programs:
* A single click with the mouse starts a program
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* 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
* 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"
* 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"
* 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`)
* 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.
* 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).
at least clicks).
For stability reasons, only programs are shown that are known to
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
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.
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
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
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
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
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
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
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
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
* The program status
* Stopped , not running
* Stopped , not running
* Ready, 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
* 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)
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
* 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
* 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.
* 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.
* 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
== Program-Database
Argodejos launcher is based on a program database, which is partly self-generated, partly
Agordejos 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
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.
installed on your system.
The database is created at the first start. Depending on your system, this can take some moments to
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
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
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.
programs.
If you do not see an installed program in our launcher, but you are sure that it supports session
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
== Tray
Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
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.
program and the session is not terminated, but minimized to the tray.
A right click on the icon gives you access to common functions:
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.
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
== Network Sessions
@ -255,26 +255,26 @@ version.
== Program parameters
== 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.
complete list please use the --help parameter.
For example:
For example:
* `--session newAlbum/mySong` starts the given session.
* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active 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.
* `--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.
* `--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
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.
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
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Argodejo Continue" to start this mode directly.
"Agordejo Continue" to start this mode directly.
== Miscellaneous / Explanations / FAQ
== 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
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
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.
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
*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.
(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.
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
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
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
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
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
`~/.config/LaborejoSoftwareSuite/agordejo`. 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
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.
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 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,
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,
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).
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.
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
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
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
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
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.
(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
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
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
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
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
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
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
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.
even complex technical scenarios, e.g. distributing sessions over the network.
// Don't write in the empty line above line. It will be interpreted as author html tag
// Don't write in the empty line above line. It will be interpreted as author html tag
Für Programmversion 0.1
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
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
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.
vereinfachen sie zumindest stark.
Im Gegensatz zum erwähnten selbstgeschriebenen Script müssen Sie sich nicht im Vorraus für ein
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
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.
=== Anwendungsbeispiel
=== Anwendungsbeispiel
* Argodejo starten (Startmenü, Terminal etc.)
* Agordejo starten (Startmenü, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der große Knopf: "Starte Neue Session"
* Der große Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschließend) dessen grafische Oberfläche
* 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.
* 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
* 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"
* 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
* 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`)
* 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.
* 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.
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
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
Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie können jederzeit hin- und herschalten.
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.
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
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
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.
Änderungen.
Hier gibt es auch die Möglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
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).
* Den Programmstatus (auf Englisch, da es sich um definierte Schlüsselworte handelt).
* Stopped / Gestoppt, läuft nicht
* Stopped / Gestoppt, läuft nicht
* Ready / Läuft und Bereit
* 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
* 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)
* Sichtbarkeit (Ein Kreuz für sichtbar, Leer für unsichtbar)
* Änderungen - Gibt es momentan ungespeicherte Änderungen?
* Ä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
* 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.
* 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.
* 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
== 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
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.
das angeboten wird, was Sie auch tatsächlich installiert haben.
Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
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
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
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.
neuen Programme zur Verfügung.
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@ -279,10 +279,10 @@ Verzeichnis.
== Tray
== Tray
Argodejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Agordejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
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.
Programm und die Session nicht beendet, sondern in den Tray minimiert.
Ein Rechtsklick auf das Icon bietet Schnellzugriff auf häufige Funktionen:
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.
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
== Netzwerk-Sessions
@ -301,25 +301,25 @@ vorgesehen.
== Programmparameter
== 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.
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.
Eine Auswahl:
Eine Auswahl:
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte 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.
* `--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.
* `--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
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.
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
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.
== Verschiedenes / Erklärungen / FAQ
== 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
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
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
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*:
*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)
Aber Sie können die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir können zusammen an der Unterstützung arbeiten.
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.
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
*Agordejo 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 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
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
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.
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
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?*:
*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.*:
*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
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
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
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
Sie sollten sich nicht genötigt fühlen plötzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
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
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
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.
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
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",
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
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
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
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.
herzustellen? Dann sollte das geschehen.
Session Management ist außerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.
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
== 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
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*
.Abhängigkeiten*
* Eine Liste der Abhängigkeit befindet sich in der README.md
* Eine Liste der Abhängigkeit befindet sich in der README.md
* Kompilieren und Installieren geht entweder mit einem Releasedownload oder mit der Git-Version:
* 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.
** Laden Sie von https://www.laborejo.org/downloads die aktuelle Version herunter und entpacken Sie sie.
@ -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
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
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.
vereinfachen sie zumindest stark.
Im Gegensatz zum erwähnten selbstgeschriebenen Script müssen Sie sich nicht im Vorraus für ein
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
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.
=== Anwendungsbeispiel
=== Anwendungsbeispiel
* Argodejo starten (Startmenü, Terminal etc.)
* Agordejo starten (Startmenü, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der große Knopf: "Starte Neue Session"
* Der große Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschließend) dessen grafische Oberfläche
* 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.
* 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
* 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"
* 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
* 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`)
* 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.
* 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.
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
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
Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie können jederzeit hin- und herschalten.
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.
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
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
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.
Änderungen.
Hier gibt es auch die Möglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
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).
* Den Programmstatus (auf Englisch, da es sich um definierte Schlüsselworte handelt).
* Stopped / Gestoppt, läuft nicht
* Stopped / Gestoppt, läuft nicht
* Ready / Läuft und Bereit
* 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
* 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)
* Sichtbarkeit (Ein Kreuz für sichtbar, Leer für unsichtbar)
* Änderungen - Gibt es momentan ungespeicherte Änderungen?
* Ä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
* 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.
* 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.
* 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
== 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
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.
das angeboten wird, was Sie auch tatsächlich installiert haben.
Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
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
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
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.
neuen Programme zur Verfügung.
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@ -250,10 +250,10 @@ Verzeichnis.
== Tray
== Tray
Argodejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Agordejo verfügt über ein Tray-Icon, sofern ihr Windowmanager das unterstüzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
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.
Programm und die Session nicht beendet, sondern in den Tray minimiert.
Ein Rechtsklick auf das Icon bietet Schnellzugriff auf häufige Funktionen:
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.
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
== Netzwerk-Sessions
@ -272,25 +272,25 @@ vorgesehen.
== Programmparameter
== 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.
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.
Eine Auswahl:
Eine Auswahl:
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte 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.
* `--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.
* `--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
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.
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
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.
== Verschiedenes / Erklärungen / FAQ
== 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
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
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
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*:
*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)
Aber Sie können die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir können zusammen an der Unterstützung arbeiten.
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.
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
*Agordejo 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 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
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
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.
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
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?*:
*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.*:
*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
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
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
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
Sie sollten sich nicht genötigt fühlen plötzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
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
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
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.
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
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",
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
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
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
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.
herzustellen? Dann sollte das geschehen.
Session Management ist außerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.
Session Management ist außerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.
<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
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.</p>
in general.</p>
</div>
</div>
@ -509,7 +509,7 @@ in general.</p>
control and a detailed overview.</p>
control and a detailed overview.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
it with some tricks of its own, that always remain 100% compatible with the original sessions.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
break things when trying out corner cases and hacks.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
should provide a good user experience.</p>
</div>
</div>
</div>
</div>
@ -552,18 +552,18 @@ real time, have synchronized timelines and play in the same tempo.</p>
<divclass="paragraph">
<divclass="paragraph">
<p>What remains is the tedious work of always starting all programs, loading project files, connecting
<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)
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>
<divclass="paragraph">
<divclass="paragraph">
<p>In contrast to the self-written script mentioned above, you don’t have to decide in advance on a
<p>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.</p>
setup, but everything is saved automatically as long as you manage everything through Agordejo.</p>
</div>
</div>
<divclass="sect2">
<divclass="sect2">
<h3id="_example">2.1. Example</h3>
<h3id="_example">2.1. Example</h3>
<divclass="ulist">
<divclass="ulist">
<ul>
<ul>
<li>
<li>
<p>Start Argodejo (Start menu, terminal etc.)</p>
<p>Start Agordejo (Start menu, terminal etc.)</p>
</li>
</li>
<li>
<li>
<p>You are now in the "Quick View" to start a session</p>
<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>
<p>If the program crashes you get a warning and can restart it.</p>
</li>
</li>
<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>
<li>
<li>
<p>To get more programs and advanced features you can switch to the tab "Full View</p>
<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>
<p>If you are finished you can return to the session selection by pressing the button "Save and Close"</p>
</li>
</li>
<li>
<li>
<p>Now Argodejo could be closed itself.</p>
<p>Now Agordejo could be closed itself.</p>
</li>
</li>
<li>
<li>
<p>All stored data is in a single directory on the hard disk (<code>~/NSM Sessions/My Song</code>)</p>
<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>
<divclass="paragraph">
<divclass="paragraph">
<p>For stability reasons, only programs are shown that are known to
<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>
<divclass="paragraph">
<divclass="paragraph">
<p>The Quick View is only a view. There is no technical difference to the full view and you can switch
<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
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
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
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.</p>
don’t need to restart Agordejo to do this, it will respond to the changes while running.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
<p>There is also the possibility to remove a so-called "lock" file. This is a file which is created
<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
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
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
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>
<p>Ready, running</p>
</li>
</li>
<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>
<li>
<li>
<p>Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading</p>
<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>
<p>Add Client offers the option to add any program, whether it is in the program database or not.</p>
</li>
</li>
<li>
<li>
<p>Any installed programs are suggested. Argodejo doesn’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’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>
</li>
</ul>
</ul>
</div>
</div>
@ -856,8 +856,8 @@ lyrics, credits and sources from external Samples etc.</p>
<p>Argodejos launcher is based on a program database, which is partly self-generated, partly
<p>Agordejos 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
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.</p>
installed on your system.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
@ -867,7 +867,7 @@ a few minutes.</p>
<divclass="paragraph">
<divclass="paragraph">
<p>If you are reinstalling or uninstalling audio programs, you will need to update the database via
<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
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>
programs.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
@ -902,11 +902,11 @@ search paths. One absolute directory path per line, no wildcards, trailing slash
<h2id="_tray">6. Tray</h2>
<h2id="_tray">6. Tray</h2>
<divclass="sectionbody">
<divclass="sectionbody">
<divclass="paragraph">
<divclass="paragraph">
<p>Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
<p>Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.</p>
hides Agordejo.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
program and the session is not terminated, but minimized to the tray.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<p>If a session is already running you can save, cancel etc.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
<p>Argodejo can also be completely exited here.</p>
<p>Agordejo can also be completely exited here.</p>
</div>
</div>
</div>
</div>
</div>
</div>
@ -936,7 +936,7 @@ version.</p>
<h2id="_program_parameters">8. Program parameters</h2>
<h2id="_program_parameters">8. Program parameters</h2>
<divclass="sectionbody">
<divclass="sectionbody">
<divclass="paragraph">
<divclass="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>
complete list please use the --help parameter.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
@ -951,7 +951,7 @@ complete list please use the --help parameter.</p>
<p><code>--continue</code> starts the last active session.</p>
<p><code>--continue</code> starts the last active session.</p>
</li>
</li>
<li>
<li>
<p><code>--hide</code> starts Argodejo as TrayIcon.</p>
<p><code>--hide</code> starts Agordejo as TrayIcon.</p>
</li>
</li>
<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>
<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>
<divclass="paragraph">
<divclass="paragraph">
<p>The combination of <code>--continue</code> and <code>--hide</code> is essentially what many people expect from Session
<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.
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
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Argodejo Continue" to start this mode directly.</p>
"Agordejo Continue" to start this mode directly.</p>
</div>
</div>
</div>
</div>
</div>
</div>
@ -973,7 +973,7 @@ If your system uses a start menu you will find not only the normal Argodejo star
@ -1107,10 +1107,10 @@ If it is not there, or only in an outdated version, please ask your Linux distri
</ul>
</ul>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<divclass="paragraph">
<divclass="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>
be helpful for testing and development.</p>
</div>
</div>
</div>
</div>
@ -1119,7 +1119,7 @@ be helpful for testing and development.</p>
<h2id="_help_and_development">11. Help and Development</h2>
<h2id="_help_and_development">11. Help and Development</h2>
<divclass="sectionbody">
<divclass="sectionbody">
<divclass="paragraph">
<divclass="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>
<divclass="sect2">
<divclass="sect2">
<h3id="_testing_and_reporting_errors">11.1. Testing and Reporting Errors</h3>
<h3id="_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
<divclass="sect2">
<divclass="sect2">
<h3id="_translations">11.3. Translations</h3>
<h3id="_translations">11.3. Translations</h3>
<divclass="paragraph">
<divclass="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>
The easiest way is to contact the developers and they will setup the new language.</p>
</div>
</div>
<divclass="paragraph">
<divclass="paragraph">
@ -1204,7 +1204,7 @@ The easiest way is to contact the developers and they will setup the new languag
</ul>
</ul>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<divclass="ulist">
<divclass="ulist">
<ul>
<ul>
@ -1233,12 +1233,12 @@ The easiest way is to contact the developers and they will setup the new languag
</ul>
</ul>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<p>Argodejo starten (Startmenü, Terminal etc.)</p>
<p>Agordejo starten (Startmenü, Terminal etc.)</p>
</li>
</li>
<li>
<li>
<p>Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten</p>
<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>
<p>Sollte das Programm abstürzen bekommt man das signalisiert und kann es neustarten.</p>
</li>
</li>
<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>
<li>
<li>
<p>Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln</p>
<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>
<p>Ist man soweit fertig kommt man durch den Knopf "Speichern und Schließen" wieder in die Sessionauswahl zurück</p>
</li>
</li>
<li>
<li>
<p>Nun könnte Argodejo geschlossen werden.</p>
<p>Nun könnte Agordejo geschlossen werden.</p>
</li>
</li>
<li>
<li>
<p>Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (<code>~/NSM Sessions/Mein Lied</code>)</p>
<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>
<divclass="paragraph">
<divclass="paragraph">
<p>Aus Stabilitätsgründen werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
<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>
<divclass="paragraph">
<divclass="paragraph">
<p>Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
<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.
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
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
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>
Änderungen.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<p>Ready / Läuft und Bereit</p>
</li>
</li>
<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>
<li>
<li>
<p>Weitere Zustände sind nur Übergänge und meist nur sehr kurz zu sehen, z.B. Open / Läd gerade</p>
<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>
<p>Client Hinzufügen bietet die Option ein beliebiges Programm hinzuzufügen, egal ob es in der Programmdatenbank ist, oder nicht.</p>
</li>
</li>
<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>
<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>
angeben. Für eine vollständige Liste benutzen Sie bitte den --help Parameter.</p>
</div>
</div>
<divclass="paragraph">
<divclass="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>
<p><code>--continue</code> startet die zuletzt benutzte Session</p>
</li>
</li>
<li>
<li>
<p><code>--hide</code> startet Argodejo als Trayicon.</p>
<p><code>--hide</code> startet Agordejo als Trayicon.</p>
</li>
</li>
<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>
<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.<
<divclass="paragraph">
<divclass="paragraph">
<p>Die Kombination von <code>--continue</code> und <code>--hide</code> ergibt einen Modus, den viele Leute vom Session Management
<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.
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
Falls Ihr System über ein Startmenü verfügt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.</p>
auch eine "Agordejo Continue"-Verknüpfung für genau diesen Modus.</p>
</div>
</div>
</div>
</div>
</div>
</div>
@ -964,7 +964,7 @@ auch eine "Argodejo Continue"-Verknüpfung für genau diesen Modus.</p>
<p>Laden Sie von <ahref="https://www.laborejo.org/downloads"class="bare">https://www.laborejo.org/downloads</a> die aktuelle Version herunter und entpacken Sie sie.</p>
<p>Laden Sie von <ahref="https://www.laborejo.org/downloads"class="bare">https://www.laborejo.org/downloads</a> die aktuelle Version herunter und entpacken Sie sie.</p>
@ -68,7 +68,7 @@ class SupportedProgramsDatabase(object):
self.grepexcluded=(pathlib.Path(PATHS["share"],"grepexcluded.txt"))#created by hand. see docstring
self.grepexcluded=(pathlib.Path(PATHS["share"],"grepexcluded.txt"))#created by hand. see docstring
#assert self.grepexcluded.exists()
#assert self.grepexcluded.exists()
self.blacklist=("nsmd","non-daw","carla","argodejo","adljack","argodejo.bin")#only programs that have to do with audio and music. There is another general blacklist that speeds up discovery
self.blacklist=("nsmd","non-daw","carla","agordejo","adljack","agordejo.bin")#only programs that have to do with audio and music. There is another general blacklist that speeds up discovery
@ -89,7 +89,7 @@ class SupportedProgramsDatabase(object):
"amsynth":"amsynth.desktop",
"amsynth":"amsynth.desktop",
}
}
self._reverseKnownDesktopFiles=dict(zip(self.knownDesktopFiles.values(),self.knownDesktopFiles.keys()))#to lookup the exe by desktoip name
self._reverseKnownDesktopFiles=dict(zip(self.knownDesktopFiles.values(),self.knownDesktopFiles.keys()))#to lookup the exe by desktoip name
self.programs=[]#list of dicts. guaranteed keys: argodejoExec, name, argodejoFullPath. And probably others, like description and version.
self.programs=[]#list of dicts. guaranteed keys: agordejoExec, name, agordejoFullPath. And probably others, like description and version.
self.nsmExecutables=set()#set of executables for fast membership, if a GUI wants to know if they are available. Needs to be build "manually" with self.programs. no auto-property for a list. at least we don't want to do the work.
self.nsmExecutables=set()#set of executables for fast membership, if a GUI wants to know if they are available. Needs to be build "manually" with self.programs. no auto-property for a list. at least we don't want to do the work.
#.build needs to be called from the api/GUI.
#.build needs to be called from the api/GUI.
#self.unfilteredExecutables = self.buildCache_unfilteredExecutables() #This doesn't take too long. we can start that every time. It will get updated in build as well.
#self.unfilteredExecutables = self.buildCache_unfilteredExecutables() #This doesn't take too long. we can start that every time. It will get updated in build as well.
@ -170,7 +170,7 @@ class SupportedProgramsDatabase(object):
self.programs=cache["programs"]#list of dicts
self.programs=cache["programs"]#list of dicts
findicons.updateCache(cache["iconPaths"])
findicons.updateCache(cache["iconPaths"])
logger.info("Restoring program list from serialized cache")
logger.info("Restoring program list from serialized cache")
self.label_help_launcher_whitelist.setText(_translate("Dialog","Whitelist - Add executable names (not paths) to the program launcher. One executable per line."))
self.label_help_launcher_whitelist.setText(_translate("Dialog","Whitelist - Add executable names (not paths) to the program launcher. One executable per line."))
self.label_help_launcher_blacklist.setText(_translate("Dialog","Blacklist - Exclude executable names (not paths) from the program launcher. One executable per line."))
self.label_help_launcher_blacklist.setText(_translate("Dialog","Blacklist - Exclude executable names (not paths) from the program launcher. One executable per line."))
self.label_help_programstart.setText(_translate("Dialog","For advanced users only! Add executable paths to the environment, just for Argodejo and NSM. Changes need a program restart afterwards. If you want your programs in the application launcher use the launcher tab."))
self.label_help_programstart.setText(_translate("Dialog","For advanced users only! Add executable paths to the environment, just for Agordejo and NSM. Changes need a program restart afterwards. If you want your programs in the application launcher use the launcher tab."))
self.label_help_path_rules.setText(_translate("Dialog","Add one absolute path to a directory (e.g. /home/user/audio-bin) per line. No wildcards. Trailing slashes/ don\'t matter."))
self.label_help_path_rules.setText(_translate("Dialog","Add one absolute path to a directory (e.g. /home/user/audio-bin) per line. No wildcards. Trailing slashes/ don\'t matter."))
<string>For advanced users only! Add executable paths to the environment, just for Argodejo and NSM. Changes need a program restart afterwards. If you want your programs in the application launcher use the launcher tab.</string>
<string>For advanced users only! Add executable paths to the environment, just for Agordejo and NSM. Changes need a program restart afterwards. If you want your programs in the application launcher use the launcher tab.</string>
@ -138,8 +138,8 @@ class StarterClientItem(QtWidgets.QListWidgetItem):
ico=QtGui.QIcon(pixmap)
ico=QtGui.QIcon(pixmap)
self.setIcon(ico)
self.setIcon(ico)
else:
else:
ifself.argodejoExecinself.parentController.mainWindow.programIcons:#there was a strange bug once where this happened exactly one, and then everything was fine, including this icon. Some DB backwards compatibility.
ifself.agordejoExecinself.parentController.mainWindow.programIcons:#there was a strange bug once where this happened exactly one, and then everything was fine, including this icon. Some DB backwards compatibility.
@ -61,7 +61,7 @@ class SystemTray(QtWidgets.QSystemTrayIcon):
nsmSessionName=api.currentSession()
nsmSessionName=api.currentSession()
_add(QtCore.QCoreApplication.translate("TrayIcon","Hide/Show Argodejo"),lambda:self.mainWindow.toggleVisible(force=None))#explicit force=None because the qt signal is sending a bool
_add(QtCore.QCoreApplication.translate("TrayIcon","Hide/Show Agordejo"),lambda:self.mainWindow.toggleVisible(force=None))#explicit force=None because the qt signal is sending a bool
menu.addSeparator()
menu.addSeparator()
#Add other pre-defined actions
#Add other pre-defined actions
@ -75,8 +75,8 @@ class SystemTray(QtWidgets.QSystemTrayIcon):
_add(QtCore.QCoreApplication.translate("TrayIcon","Save && Close {}".format(nsmSessionName)),api.sessionClose)
_add(QtCore.QCoreApplication.translate("TrayIcon","Save && Close {}".format(nsmSessionName)),api.sessionClose)
_add(QtCore.QCoreApplication.translate("TrayIcon","Close without Saving {}".format(nsmSessionName)),api.sessionAbort)
_add(QtCore.QCoreApplication.translate("TrayIcon","Close without Saving {}".format(nsmSessionName)),api.sessionAbort)
HARD_LIMIT = 512 # no single message longer than this
HARD_LIMIT = 512 # no single message longer than this
VERSION= 1.0
VERSION= 1.0
#In case the user tries to run this standalone.
#In case the user tries to run this standalone.
import argparse
import argparse
parser = argparse.ArgumentParser(description="nsm-data is a module for Argodejo. It only communicates over OSC in an NSM-Session and has no standalone functionality.")
parser = argparse.ArgumentParser(description="nsm-data is a module for Agordejo. It only communicates over OSC in an NSM-Session and has no standalone functionality.")
Nils
4 years ago