Browse Source

Fix name of the whole project. Argodejo -> Agordejo

master
Nils 3 years ago
parent
commit
3213ec5f3d
  1. 3
      CHANGELOG
  2. 10
      Makefile.in
  3. 20
      README.md
  4. 0
      agordejo
  5. 2
      configure
  6. 6
      desktop/agordejo-continue.desktop
  7. 6
      desktop/desktop.desktop
  8. 26
      documentation/argodejo.1
  9. 2
      documentation/build.py
  10. 88
      documentation/english.adoc
  11. 60
      documentation/english.part.adoc
  12. 82
      documentation/german.adoc
  13. 60
      documentation/german.part.adoc
  14. 2
      documentation/index.adoc
  15. 18
      documentation/manpageinclude.h2m
  16. 2
      documentation/nsm-data.1
  17. 90
      documentation/out/english.html
  18. 84
      documentation/out/german.html
  19. 4
      documentation/out/index.html
  20. 2
      engine/api.py
  21. 12
      engine/config.py
  22. 32
      engine/findprograms.py
  23. 42
      engine/nsmservercontrol.py
  24. 2
      qtgui/designer/mainwindow.py
  25. 2
      qtgui/designer/mainwindow.ui
  26. 2
      qtgui/designer/settings.py
  27. 2
      qtgui/designer/settings.ui
  28. 16
      qtgui/mainwindow.py
  29. 18
      qtgui/opensessioncontroller.py
  30. 36
      qtgui/quickopensessioncontroller.py
  31. BIN
      qtgui/resources/translations/de.qm
  32. 28
      qtgui/resources/translations/de.ts
  33. 6
      qtgui/systemtray.py
  34. 48
      tools/nsm-data
  35. 1
      tools/nsmservercontrol.py
  36. 1730
      tools/nsmservercontrol.py

3
CHANGELOG

@ -1,3 +1,6 @@
2020-10-15 0.2
Correct typo in the name of the project :) Sorry.
2020-07-15 0.1 Proof of Concept
A lot is working already, single-computer session are working fine.
Network sessions of any form are not usable yet.

10
Makefile.in

@ -34,14 +34,14 @@ install:
#nsm-data
install -D -m 755 "nsm-data.bin" $(DESTDIR)$(PREFIX)/bin/nsm-data
#Argodejo
#Agordejo
install -D -m 755 $(PROGRAM).bin $(DESTDIR)$(PREFIX)/bin/$(PROGRAM)
install -D -m 644 documentation/out/* -t $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)
install -D -m 644 README.md $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)/README.md
install -D -m 644 LICENSE $(DESTDIR)$(PREFIX)/share/doc/$(PROGRAM)/LICENSE
install -D -m 644 desktop/desktop.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo.desktop
install -D -m 644 desktop/argodejo-continue.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo-continue.desktop
install -D -m 644 desktop/desktop.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo.desktop
install -D -m 644 desktop/agordejo-continue.desktop $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo-continue.desktop
install -d $(DESTDIR)$(PREFIX)/share/man/man1
gzip -c documentation/$(PROGRAM).1 > $(DESTDIR)$(PREFIX)/share/man/man1/$(PROGRAM).1.gz
@ -66,8 +66,8 @@ uninstall:
#Files
rm -f $(DESTDIR)$(PREFIX)/bin/$(PROGRAM)
rm -f $(DESTDIR)$(PREFIX)/bin/nsm-data
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.argodejo-continue.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo.desktop
rm -f $(DESTDIR)$(PREFIX)/share/applications/org.laborejo.agordejo-continue.desktop
rm -f $(DESTDIR)$(PREFIX)/share/man/man1/$(PROGRAM).1.gz
#Icons

20
README.md

@ -1,11 +1,11 @@
[//]: # (Generated 2020-06-11T19:20:27.804895. Changes belong into template/documentation/readme.template)
#Argodejo
#Agordejo
Program version 0.1
Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.
@ -14,7 +14,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.
Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.
@ -24,7 +24,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.
That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
@ -35,7 +35,7 @@ This README is just a short introduction. Consult the manual (see below) for mor
* Website https://www.laborejo.org
* Bugs and Issues: https://www.laborejo.org/bugs
* Git Repositories for all programs: https://git.laborejo.org
* Documentation and Manual https://www.laborejo.org/documentation/argodejo
* Documentation and Manual https://www.laborejo.org/documentation/agordejo
# Installation and Starting
@ -48,7 +48,7 @@ Download the latest code release on https://www.laborejo.org/downloads and extra
### Git Version
It is possible to clone a git repository.
`git clone https://git.laborejo.org/lss/argodejo.git`
`git clone https://git.laborejo.org/lss/agordejo.git`
## Dependencies
* Glibc
@ -73,11 +73,11 @@ It is possible to clone a git repository.
## Starting
If you installed Argodejo through a packager manager or yourself simple use your application launcher
or terminal to start the executable `argodejo`
If you installed Agordejo through a packager manager or yourself simple use your application launcher
or terminal to start the executable `agordejo`
You can also run Argodejo after extracting the release archive or cloning from git, without make or
You can also run Agordejo after extracting the release archive or cloning from git, without make or
installation. If you did so, for additional features please link tools/nsm-data to your executable PATH.
Use the manpage `man argodejo` or run `argodejo --help` (or local variant `./argodejo --help` )
Use the manpage `man agordejo` or run `agordejo --help` (or local variant `./agordejo --help` )
to see available command line parameters.

0
argodejo → agordejo

2
configure

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

6
desktop/argodejo-continue.desktop → desktop/agordejo-continue.desktop

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

6
desktop/desktop.desktop

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

26
documentation/argodejo.1

@ -1,14 +1,14 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.15.
.TH ARGODEJO "1" "June 2020" "Argodejo 0.1" "User Commands"
.TH ARGODEJO "1" "June 2020" "Agordejo 0.1" "User Commands"
.SH NAME
Argodejo - Music and audio production session manager based on NSM.
Agordejo - Music and audio production session manager based on NSM.
.SH DESCRIPTION
usage: argodejo [\-h] [\-v] [\-V] [\-u URL] [\-\-nsm\-url URL] [\-s SESSION] [\-c] [\-i]
usage: agordejo [\-h] [\-v] [\-V] [\-u URL] [\-\-nsm\-url URL] [\-s SESSION] [\-c] [\-i]
.IP
[\-\-session\-root SESSIONROOT]
.PP
Argodejo \- Version 0.1 \- Copyright 2020 by Laborejo Software Suite \-
https://www.laborejo.org/argodejo
Agordejo \- Version 0.1 \- Copyright 2020 by Laborejo Software Suite \-
https://www.laborejo.org/agordejo
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR
@ -47,7 +47,7 @@ Root directory of all sessions. Defaults to '$HOME/NSM
Sessions'
.SH USAGE
Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.
@ -56,7 +56,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.
Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.
@ -66,21 +66,21 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.
That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
.SH EXAMPLES
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.
.SH "REPORTING BUGS"
https://www.laborejo.org/bugs
.SH COPYRIGHT
Argodejo 0.1 - Copyright 2020
Agordejo 0.1 - Copyright 2020
Laborejo Software Suite
https://www.laborejo.org/
.SH "SEE ALSO"
The full documentation for Argodejo is maintained as a multi-lingual html site to your systems doc-dir.
The full documentation for Agordejo is maintained as a multi-lingual html site to your systems doc-dir.
For example:
xdg-open file:///usr/share/doc/argodejo/index.html
xdg-open file:///usr/share/doc/agordejo/index.html
The documentation can also be found online https://www.laborejo.org/documentation/argodejo
The documentation can also be found online https://www.laborejo.org/documentation/agordejo

2
documentation/build.py

@ -102,7 +102,7 @@ https://www.laborejo.org/bugs
https://www.laborejo.org/
[examples]
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.

88
documentation/english.adoc

@ -22,7 +22,7 @@ https://asciidoctor.org/docs/user-manual/
:toc-title: Table of Contents
:toclevels: 3
= Argodejo
= Agordejo
// Don't write in the empty line above line. It will be interpreted as author html tag
For program version 0.1
@ -30,7 +30,7 @@ For program version 0.1
== Introduction
Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.
@ -39,7 +39,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.
Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.
@ -49,7 +49,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.
That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
@ -74,25 +74,25 @@ real time, have synchronized timelines and play in the same tempo.
What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.
In contrast to the self-written script mentioned above, you don't have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.
setup, but everything is saved automatically as long as you manage everything through Agordejo.
=== Example
* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Now you get a choice of programs:
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.
* To get more programs and advanced features you can switch to the tab "Full View
* The name of the session so far is simply a date. By clicking on it you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by pressing the button "Save and Close"
* Now Argodejo could be closed itself.
* Now Agordejo could be closed itself.
* All stored data is in a single directory on the hard disk (`~/NSM Sessions/My Song`)
* The session can be resumed: After clicking on the name, all programs start automatically and connect their JACK ports to among themselves.
@ -106,7 +106,7 @@ decisions as possible and start an old session or create a new one as quickly as
at least clicks).
For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.
work correctly with Agordejos session management.
The Quick View is only a view. There is no technical difference to the full view and you can switch
back and forth at any time.
@ -184,10 +184,10 @@ Each session has a context menu (e.g. right mouse button) with further options:
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don't need to restart Argodejo to do this, it will respond to the changes while running.
don't need to restart Agordejo to do this, it will respond to the changes while running.
There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@ -221,7 +221,7 @@ The following information is available per program:
* The program status
* Stopped , not running
* Ready, running
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)
* Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
@ -250,12 +250,12 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Abort ends the session without saving the programs
* Save As saves the session under a different name and closes the current session without saving. From now on you work under the new name.
* Add Client offers the option to add any program, whether it is in the program database or not.
* Any installed programs are suggested. Argodejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `argodejo` itself.
* Any installed programs are suggested. Agordejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `agordejo` itself.
== Program-Database
Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.
The database is created at the first start. Depending on your system, this can take some moments to
@ -263,7 +263,7 @@ a few minutes.
If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.
If you do not see an installed program in our launcher, but you are sure that it supports session
@ -287,10 +287,10 @@ These search paths are not stored in the session, but locally in your `~/.config
== Tray
Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.
If you close Argodejo using the normal window manager function, such as a click on the [X], the
If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.
A right click on the icon gives you access to common functions:
@ -299,7 +299,7 @@ You can directly start the most recently used sessions.
If a session is already running you can save, cancel etc.
Argodejo can also be completely exited here.
Agordejo can also be completely exited here.
== Network Sessions
@ -310,26 +310,26 @@ version.
== Program parameters
As an advanced user, you can start Argodejo in the terminal and add some parameters.. For a
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
complete list please use the --help parameter.
For example:
* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active session.
* `--hide` starts Argodejo as TrayIcon.
* `--hide` starts Agordejo as TrayIcon.
* `--url osc.udp://myhost.localdomain:14294/` connects to this server, if available, or starts the internal session server at this address. This is a very technical option and probably not needed.
* `--session-root /home/user/production2030` sets the root directory. Only sessions in this directory are displayed, everything is stored here.
The combination of `--continue` and `--hide` is essentially what many people expect from Session
Management: Resuming at the previous state, without any extra windows in their way.
If your system uses a start menu you will find not only the normal Argodejo starter but also
"Argodejo Continue" to start this mode directly.
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Agordejo Continue" to start this mode directly.
== Miscellaneous / Explanations / FAQ
*Session Save and Exit responds slowly*: Argodejo is not a standalone program like an word
*Session Save and Exit responds slowly*: Agordejo is not a standalone program like an word
processor. The participating programs in the session are not plugins either. When you end the
session a signal is sent to all participating client to save. This may take a few moments where
you are able to see "live" how individual programs terminate and disappear from the session.
@ -337,7 +337,7 @@ Everything is fine.
*I have added a program but it does not save with the session*: Does the program support session
management? If not, Argodejo cannot do much. But you can ask the program developers to contact us
management? If not, Agordejo cannot do much. But you can ask the program developers to contact us
(info@laborejo.org) and we can work together on support.
@ -346,13 +346,13 @@ we are also interested in improving the situation by offering at least an emerge
future.
*Argodejo won't start! I start the program but I can't see anything*: Most likely Argodejo is
*Agordejo won't start! I start the program but I can't see anything*: Most likely Agordejo is
running, but invisible, because you exited it from the tray last time. Is it in the tray? A
message should have popped up, maybe you missed it. If there is no tray in your window manager, the
program should always be visible. With all these special window managers in Linux it may be that
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Argodejo will behave like the
`~/.config/LaborejoSoftwareSuite/agordejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.
@ -366,7 +366,7 @@ inevitable crashes).
*A program update broke my session because it can no longer load its files.* Unfortunately, this is
a problem that even Argodejo can't solve. It also happens with LV2 plugins and with all other
a problem that even Agordejo can't solve. It also happens with LV2 plugins and with all other
software, such as office programs. If you fear that a program becomes incompatible in the future,
write down its version number in the session notes, so that you can at least, in an emergency,
reinstall the old program version (even if this is very is cumbersome).
@ -376,7 +376,7 @@ reinstall the old program version (even if this is very is cumbersome).
management is worthwhile with two or more participating programs, which one needs almost always.
You should not feel compelled to suddenly make everything modular with individual programs, only
because you use a session manager. Argodejo is designed to make your music production easier. If it
because you use a session manager. Agordejo is designed to make your music production easier. If it
is faster and more comfortable to manage all plugins and effects e.g. in a single "Carla" instance
then you should do exactly that. If you basically want to do everything in Ardour, do that, but
start Ardour anyway in session management, because no program can do everything alone and the time
@ -393,7 +393,7 @@ directly do music production, but still is connected in the grander scheme: Ope
(OBS), music player, word processors and graphic programs etc.
*Argodejo contains functionality which is not within its scope*: Music production is very complex
*Agordejo contains functionality which is not within its scope*: Music production is very complex
and complexity is inevitable. It's like a waterbed: if you press down on one side, something
bounces up in another place. When you create a "clean and lean" program, which therefore implements
only a part of the complete workflow, then the missing part pops up somewhere else. A minimalistic
@ -402,23 +402,23 @@ session manager provokes plug-ins (not LV2), helper-scripts, workarounds and hac
E.g. not to include file management provokes user errors like deleting the wrong files. If the SM
knows what to do and it can do it, then let it do it. Or crashes: Technically, crashing programs
are not the "problem" of the session managers, but they are part of the software reality. Crashes
happen every day and need to be handled. Can Argodejo simplify the work and help to restore good
happen every day and need to be handled. Can Agordejo simplify the work and help to restore good
conditions again? Then that should be done. Session management is also an opportunity to simplify
even complex technical scenarios, e.g. distributing sessions over the network.
== Installation and Start
Argodejo is exclusive for Linux. The best way to install is to use your package manager.
Agordejo is exclusive for Linux. The best way to install is to use your package manager.
If it is not there, or only in an outdated version, please ask your Linux distribution to provide a recent version.
If not available in the package repository you can build Argodejo yourself.
If not available in the package repository you can build Agordejo yourself.
.Build and Install
* Please check the supplied README.md for dependencies.
* You can download a release or clone the git version
** Download the latest version from https://www.laborejo.org/downloads and extract it.
** git clone https://git.laborejo.org/lss/argodejo.git
** git clone https://git.laborejo.org/lss/agordejo.git
* Change into the new directory and use these commands:
* `./configure --prefix=/usr`
** The default prefix is /usr/local
@ -426,14 +426,14 @@ If not available in the package repository you can build Argodejo yourself.
* `sudo make install`
Now the program is available to run via your menu/launcher or `argodejo` in a terminal.
Now the program is available to run via your menu/launcher or `agordejo` in a terminal.
Please read README.md for other ways of starting argodejo, which are impractical for actual use but can
Please read README.md for other ways of starting agordejo, which are impractical for actual use but can
be helpful for testing and development.
== Help and Development
You can help Argodejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.
You can help Agordejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.
=== Testing and Reporting Errors
If you find a bug in the program (or it runs too slow) please contact us in a way that suits you best.
@ -450,7 +450,7 @@ If you want to do some programming and don't know where to start please get in c
The short version is: clone the git, change the code, create a git patch or point me to your public git.
=== Translations
Argodejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
Agordejo is very easy to translate with the help of the Qt-Toolchain, without any need for programming.
The easiest way is to contact the developers and they will setup the new language.
However, here are the complete instructions for doing a translation completely on your own and integrating it into the program.
@ -468,7 +468,7 @@ You can add a new language like this:
* Select your "Target Language" and use the program to create a translation
* Send us the `.ts` file, such as by e-mail to info@laborejo.org
You can also incorporate the translation into Argodejo for testing purposes. This requires rudimentary Python knowledge.
You can also incorporate the translation into Agordejo for testing purposes. This requires rudimentary Python knowledge.
* Run the "Release" option in QtLinguists "File" menu. It creates a `.qm` file in the same directory as your `.ts` file.
* Edit `qtgui/resources/resources.qrc` and duplicate the line `<file>translations/de.qm</file>` but change it to your new .qm file.
@ -477,6 +477,6 @@ You can also incorporate the translation into Argodejo for testing purposes. Thi
** To find out your language string (German, Esperanto etc.) open the `python3` interpreter in a terminal and run the following command:
** `from PyQt5 import QtCore;QtCore.QLocale().languageToString(QtCore.QLocale().language())`
To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start argodejo via the terminal:
To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start agordejo via the terminal:
* `LANGUAGE=de_DE.UTF-8 ./argodejo -V --save /dev/null`
* `LANGUAGE=de_DE.UTF-8 ./agordejo -V --save /dev/null`

60
documentation/english.part.adoc

@ -19,25 +19,25 @@ real time, have synchronized timelines and play in the same tempo.
What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.
In contrast to the self-written script mentioned above, you don't have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.
setup, but everything is saved automatically as long as you manage everything through Agordejo.
=== Example
* Start Argodejo (Start menu, terminal etc.)
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Now you get a choice of programs:
* A single click with the mouse starts a program
* Another click hides (or subsequently shows) its graphical interface
* If the program crashes you get a warning and can restart it.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.
* Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.
* To get more programs and advanced features you can switch to the tab "Full View
* The name of the session so far is simply a date. By clicking on it you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by pressing the button "Save and Close"
* Now Argodejo could be closed itself.
* Now Agordejo could be closed itself.
* All stored data is in a single directory on the hard disk (`~/NSM Sessions/My Song`)
* The session can be resumed: After clicking on the name, all programs start automatically and connect their JACK ports to among themselves.
@ -51,7 +51,7 @@ decisions as possible and start an old session or create a new one as quickly as
at least clicks).
For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.
work correctly with Agordejos session management.
The Quick View is only a view. There is no technical difference to the full view and you can switch
back and forth at any time.
@ -129,10 +129,10 @@ Each session has a context menu (e.g. right mouse button) with further options:
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don't need to restart Argodejo to do this, it will respond to the changes while running.
don't need to restart Agordejo to do this, it will respond to the changes while running.
There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@ -166,7 +166,7 @@ The following information is available per program:
* The program status
* Stopped , not running
* Ready, running
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)
* Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)
* Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading
* Visibility (A cross for visible, blank for invisible)
* Changes - Are there currently unsaved changes?
@ -195,12 +195,12 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Abort ends the session without saving the programs
* Save As saves the session under a different name and closes the current session without saving. From now on you work under the new name.
* Add Client offers the option to add any program, whether it is in the program database or not.
* Any installed programs are suggested. Argodejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `argodejo` itself.
* Any installed programs are suggested. Agordejo doesn't check them for usefulness for a music session, or even for runnability. You will find `ls` here as well as `agordejo` itself.
== Program-Database
Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.
The database is created at the first start. Depending on your system, this can take some moments to
@ -208,7 +208,7 @@ a few minutes.
If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.
If you do not see an installed program in our launcher, but you are sure that it supports session
@ -232,10 +232,10 @@ These search paths are not stored in the session, but locally in your `~/.config
== Tray
Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.
Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.
If you close Argodejo using the normal window manager function, such as a click on the [X], the
If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.
A right click on the icon gives you access to common functions:
@ -244,7 +244,7 @@ You can directly start the most recently used sessions.
If a session is already running you can save, cancel etc.
Argodejo can also be completely exited here.
Agordejo can also be completely exited here.
== Network Sessions
@ -255,26 +255,26 @@ version.
== Program parameters
As an advanced user, you can start Argodejo in the terminal and add some parameters.. For a
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
complete list please use the --help parameter.
For example:
* `--session newAlbum/mySong` starts the given session.
* `--continue` starts the last active session.
* `--hide` starts Argodejo as TrayIcon.
* `--hide` starts Agordejo as TrayIcon.
* `--url osc.udp://myhost.localdomain:14294/` connects to this server, if available, or starts the internal session server at this address. This is a very technical option and probably not needed.
* `--session-root /home/user/production2030` sets the root directory. Only sessions in this directory are displayed, everything is stored here.
The combination of `--continue` and `--hide` is essentially what many people expect from Session
Management: Resuming at the previous state, without any extra windows in their way.
If your system uses a start menu you will find not only the normal Argodejo starter but also
"Argodejo Continue" to start this mode directly.
If your system uses a start menu you will find not only the normal Agordejo starter but also
"Agordejo Continue" to start this mode directly.
== Miscellaneous / Explanations / FAQ
*Session Save and Exit responds slowly*: Argodejo is not a standalone program like an word
*Session Save and Exit responds slowly*: Agordejo is not a standalone program like an word
processor. The participating programs in the session are not plugins either. When you end the
session a signal is sent to all participating client to save. This may take a few moments where
you are able to see "live" how individual programs terminate and disappear from the session.
@ -282,7 +282,7 @@ Everything is fine.
*I have added a program but it does not save with the session*: Does the program support session
management? If not, Argodejo cannot do much. But you can ask the program developers to contact us
management? If not, Agordejo cannot do much. But you can ask the program developers to contact us
(info@laborejo.org) and we can work together on support.
@ -291,13 +291,13 @@ we are also interested in improving the situation by offering at least an emerge
future.
*Argodejo won't start! I start the program but I can't see anything*: Most likely Argodejo is
*Agordejo won't start! I start the program but I can't see anything*: Most likely Agordejo is
running, but invisible, because you exited it from the tray last time. Is it in the tray? A
message should have popped up, maybe you missed it. If there is no tray in your window manager, the
program should always be visible. With all these special window managers in Linux it may be that
the tray detection did not work properly. Contingency plan is to delete
`~/.config/LaborejoSoftwareSuite/argodejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Argodejo will behave like the
`~/.config/LaborejoSoftwareSuite/agordejo`. This will NOT remove any sessions, but only local
settings such as the visibility of the program window. At next start Agordejo will behave like the
very first start.
@ -311,7 +311,7 @@ inevitable crashes).
*A program update broke my session because it can no longer load its files.* Unfortunately, this is
a problem that even Argodejo can't solve. It also happens with LV2 plugins and with all other
a problem that even Agordejo can't solve. It also happens with LV2 plugins and with all other
software, such as office programs. If you fear that a program becomes incompatible in the future,
write down its version number in the session notes, so that you can at least, in an emergency,
reinstall the old program version (even if this is very is cumbersome).
@ -321,7 +321,7 @@ reinstall the old program version (even if this is very is cumbersome).
management is worthwhile with two or more participating programs, which one needs almost always.
You should not feel compelled to suddenly make everything modular with individual programs, only
because you use a session manager. Argodejo is designed to make your music production easier. If it
because you use a session manager. Agordejo is designed to make your music production easier. If it
is faster and more comfortable to manage all plugins and effects e.g. in a single "Carla" instance
then you should do exactly that. If you basically want to do everything in Ardour, do that, but
start Ardour anyway in session management, because no program can do everything alone and the time
@ -338,7 +338,7 @@ directly do music production, but still is connected in the grander scheme: Ope
(OBS), music player, word processors and graphic programs etc.
*Argodejo contains functionality which is not within its scope*: Music production is very complex
*Agordejo contains functionality which is not within its scope*: Music production is very complex
and complexity is inevitable. It's like a waterbed: if you press down on one side, something
bounces up in another place. When you create a "clean and lean" program, which therefore implements
only a part of the complete workflow, then the missing part pops up somewhere else. A minimalistic
@ -347,6 +347,6 @@ session manager provokes plug-ins (not LV2), helper-scripts, workarounds and hac
E.g. not to include file management provokes user errors like deleting the wrong files. If the SM
knows what to do and it can do it, then let it do it. Or crashes: Technically, crashing programs
are not the "problem" of the session managers, but they are part of the software reality. Crashes
happen every day and need to be handled. Can Argodejo simplify the work and help to restore good
happen every day and need to be handled. Can Agordejo simplify the work and help to restore good
conditions again? Then that should be done. Session management is also an opportunity to simplify
even complex technical scenarios, e.g. distributing sessions over the network.

82
documentation/german.adoc

@ -22,7 +22,7 @@ https://asciidoctor.org/docs/user-manual/
:toc-title: Inhaltsverzeichnis
:toclevels: 3
= Argodejo
= Agordejo
// Don't write in the empty line above line. It will be interpreted as author html tag
Fรผr Programmversion 0.1
@ -50,28 +50,28 @@ Echtzeit teilen, verfรผgen รผber synchronisierte Timelines und spielen im gleich
Was รผbrig bleibt ist die leidige Arbeit jedesmal alle Programme zu starten, die Projektdateien zu
laden, alle Audiokanรคle zu verbinden usw. Session Management im allgemeinen (z.B. extra
geschriebene Starter-Scriptdateien) und Argodejo im speziellen nehmen Ihnen diese Arbeit ab, oder
geschriebene Starter-Scriptdateien) und Agordejo im speziellen nehmen Ihnen diese Arbeit ab, oder
vereinfachen sie zumindest stark.
Im Gegensatz zum erwรคhnten selbstgeschriebenen Script mรผssen Sie sich nicht im Vorraus fรผr ein
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.
=== Anwendungsbeispiel
* Argodejo starten (Startmenรผ, Terminal etc.)
* Agordejo starten (Startmenรผ, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der groรŸe Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschlieรŸend) dessen grafische Oberflรคche
* Sollte das Programm abstรผrzen bekommt man das signalisiert und kann es neustarten.
* Audio- und Midiports kรถnnen nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Argodejo gespeichert.
* Audio- und Midiports kรถnnen nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.
* Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln
* Der Name der Session ist bisher einfach ein Datum. Durch Klick auf dieses kann man einen richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Knopf "Speichern und SchlieรŸen" wieder in die Sessionauswahl zurรผck
* Nun kรถnnte Argodejo geschlossen werden.
* Nun kรถnnte Agordejo geschlossen werden.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/NSM Sessions/Mein Lied`)
* Die Session kann weitergefรผhrt werden: Nach dem Klick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.
@ -87,7 +87,7 @@ Entscheidungen wie mรถglich zu treffen haben und so schnell wie mรถglich (mit de
eine alte Session starten oder eine neue erstellen kรถnnen.
Aus Stabilitรคtsgrรผnden werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Argodejos zusammenarbeiten.
korrekt mit dem Session Management Agordejos zusammenarbeiten.
Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie kรถnnen jederzeit hin- und herschalten.
@ -167,7 +167,7 @@ Jede Session verfรผgt รผber ein Kontextmenรผ (z.B. rechte Maustaste) mit weitere
eine Session umbennen, lรถschen (inkl. aller dazugehรถrigen Dateien auf der Festplatte!) und mehr.
Diese Funktionen sind gleichwertig zu ihrem Dateimanager. Falls Sie mรถchten, kรถnnen Sie auch
einfach die Sessionverzeichnisse selbst umbennen, verschieben oder lรถschen (sofern diese nicht
gerade geรถffnet ist). Dazu muss Argodejo nicht neugestartet werden, es reagiert selbst auf die
gerade geรถffnet ist). Dazu muss Agordejo nicht neugestartet werden, es reagiert selbst auf die
ร„nderungen.
Hier gibt es auch die Mรถglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
@ -206,7 +206,7 @@ Pro Programm gibt es folgende Informationen:
* Den Programmstatus (auf Englisch, da es sich um definierte Schlรผsselworte handelt).
* Stopped / Gestoppt, lรคuft nicht
* Ready / Lรคuft und Bereit
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstรผtzt. Argodejo kann nicht wissen, ob es bereits lรคuft oder nicht. Alles ist in Ordnung! :)
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstรผtzt. Agordejo kann nicht wissen, ob es bereits lรคuft oder nicht. Alles ist in Ordnung! :)
* Weitere Zustรคnde sind nur รœbergรคnge und meist nur sehr kurz zu sehen, z.B. Open / Lรคd gerade
* Sichtbarkeit (Ein Kreuz fรผr sichtbar, Leer fรผr unsichtbar)
* ร„nderungen - Gibt es momentan ungespeicherte ร„nderungen?
@ -237,13 +237,13 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menรผs zur Verfรผgung, di
* Abbrechen beendet die Session, ohne dass die Programme abspeichern
* Speichern Unter speichert die Session unter einem anderen Namen und schlieรŸt die laufende ohne abzuspeichern. Ab nun arbeitet man in der neuen Session.
* Client Hinzufรผgen bietet die Option ein beliebiges Programm hinzuzufรผgen, egal ob es in der Programmdatenbank ist, oder nicht.
* Es werden alle installierten Programme vorgeschlagen. Argodejo รผberprรผft diese nicht auf Sinnhaftigkeit fรผr eine Musik-Session, oder auch nur auf Lauffรคhigkeit. Sie finden hier `ls` wie auch `argodejo` selbst.
* Es werden alle installierten Programme vorgeschlagen. Agordejo รผberprรผft diese nicht auf Sinnhaftigkeit fรผr eine Musik-Session, oder auch nur auf Lauffรคhigkeit. Sie finden hier `ls` wie auch `agordejo` selbst.
== Programm-Datenbank
Argodejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
Agordejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
teilweise von Hand eingepflegt wurde. Das bedeutet nichts anderes, als das alle installieren
Programme in ihrem System รผberprรผft werden (wie ein Startmenรผ) und Ihnen im Argodejo-Starter nur
Programme in ihrem System รผberprรผft werden (wie ein Startmenรผ) und Ihnen im Agordejo-Starter nur
das angeboten wird, was Sie auch tatsรคchlich installiert haben.
Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
@ -251,7 +251,7 @@ Augenblicke bis einige Minuten dauern.
Wenn Sie Audio-Programme neu installieren, oder deinstallieren mรผssen Sie die Datenbank selbst
aktualisieren. Im Steuerungsmenรผ gibt es den Befehl. Programminstallationen sind sogar mรถglich
wรคhrend Argodejo lรคuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
wรคhrend Agordejo lรคuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
neuen Programme zur Verfรผgung.
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@ -279,10 +279,10 @@ Verzeichnis.
== Tray
Argodejo verfรผgt รผber ein Tray-Icon, sofern ihr Windowmanager das unterstรผzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
Agordejo verfรผgt รผber ein Tray-Icon, sofern ihr Windowmanager das unterstรผzt. Ein Klick auf das
Trayicon zeigt oder versteckt Agordejo.
SchlieรŸt man Argodejo รผber die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
SchlieรŸt man Agordejo รผber die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Programm und die Session nicht beendet, sondern in den Tray minimiert.
Ein Rechtsklick auf das Icon bietet Schnellzugriff auf hรคufige Funktionen:
@ -291,7 +291,7 @@ Sie kรถnnen hier die zuletzt benutzen Sessions direkt starten.
Lรคuft bereits eine Session kรถnnen Sie speichern, abbrechen etc.
Argodejo kann hier auch komplett beendet werden.
Agordejo kann hier auch komplett beendet werden.
== Netzwerk-Sessions
@ -301,25 +301,25 @@ vorgesehen.
== Programmparameter
Als fortgeschrittener Benutzer kรถnnen Sie Argodejo im Terminal starten und dort einige Parameter
Als fortgeschrittener Benutzer kรถnnen Sie Agordejo im Terminal starten und dort einige Parameter
angeben. Fรผr eine vollstรคndige Liste benutzen Sie bitte den --help Parameter.
Eine Auswahl:
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte Session
* `--hide` startet Argodejo als Trayicon.
* `--hide` startet Agordejo als Trayicon.
* `--url osc.udp://myhost.localdomain:14294/` verbindet sich zu diesem Server, falls vorhanden, oder startet den internen Session-Server unter dieser Adresse. Dies ist eine sehr technische Option und wird wahrscheinlich nicht benรถtigt.
* `--session-root /home/benutzer/produktion2020` setzt das Wurzelverzeichnis. Nur Sessions in diesem Verzeichnis werden angezeigt, alles wird dort gespeichert.
Die Kombination von `--continue` und `--hide` ergibt einen Modus, den viele Leute vom Session Management
erwarten: dort weiter machen wo man aufgehรถrt hat, ohne dass Extrafenster angezeigt werden.
Falls Ihr System รผber ein Startmenรผ verfรผgt finden Sie daher neben dem normalen Argodejo-Starter
auch eine "Argodejo Continue"-Verknรผpfung fรผr genau diesen Modus.
Falls Ihr System รผber ein Startmenรผ verfรผgt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Agordejo Continue"-Verknรผpfung fรผr genau diesen Modus.
== Verschiedenes / Erklรคrungen / FAQ
*Session Speichern und Beenden reagiert langsam*: Argodejo ist kein Einzelprogramm wie ein
*Session Speichern und Beenden reagiert langsam*: Agordejo ist kein Einzelprogramm wie ein
Office-Writer. Die teilnehmenden Programme in der Session sind auch keine Plugins. Wenn Sie die
Session beenden wird ein Signal an alle teilnehmenden Programme gesendet, dass sie speichern
sollen. Das kann ein paar Momente dauern, in denen Sie "live" mitverfolgen, wie die einzelnen
@ -327,7 +327,7 @@ Programme sich beenden und aus der Session verschwinden. Es ist alles in Ordnung
*Ich habe ein Programm hinzugefรผgt aber es speichert nicht mit der Session*:
Unterstรผtzt das Programm Session Management? Wenn nicht, kann Argodejo nichts tun.
Unterstรผtzt das Programm Session Management? Wenn nicht, kann Agordejo nichts tun.
Aber Sie kรถnnen die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir kรถnnen zusammen an der Unterstรผtzung arbeiten.
@ -337,14 +337,14 @@ Das tut uns leid. Eigentlich sind die Programme selbst schuld, aber auch wir sin
interessiert die Situation zu verbessen, indem wir in Zukunft zumindest eine Notlรถsung anbieten.
*Argodejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Argodejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
*Agordejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Agordejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
hรคtte ein kleines Nachrichtenfenster aufpoppen sollen. Falls in ihrem Window-Manager kein Tray
vorhanden ist sollte das Programm immer sichtbar sein. Bei besonderen Window-Managern (bei der
groรŸen Auswahl in Linux) kann es sein, dass die Tray-Erkennung nicht richtig funktioniert hat.
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/argodejo` zu lรถschen. Dabei werden KEINE
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/agordejo` zu lรถschen. Dabei werden KEINE
Sessions gelรถscht, sondern nur lokale Einstellungen wie die Sichtbarkeit des Programmfensters. Beim
nรคchsten Start wird Argodejo sich verhalten wie beim allerersten.
nรคchsten Start wird Agordejo sich verhalten wie beim allerersten.
*JACK ist abgestรผrzt. Viele Programme hรคngen. Was tun um Datenverlust zu vermeiden?*:
@ -357,7 +357,7 @@ manuell im Dateimanager eine Kopie des Session-Verzeichnisses machen.
*Ein Programmupdate hat meine Session kaputtgemacht, weil es seine Dateien nicht mehr laden kann.*:
Das ist leider ein Problem, dass auch Argodejo nicht lรถsen kann. Es passiert mit LV2-Plugins ebenso
Das ist leider ein Problem, dass auch Agordejo nicht lรถsen kann. Es passiert mit LV2-Plugins ebenso
wie mit alle anderen Software, etwa Officeprogramme. Falls Sie befรผrchten, dass ein Programm in
Zukunft inkompatibel wird notieren Sie sich dessen Versionsnummer in den Session-Notizen, damit Sie
zumindest zur Not die alte Programmversion wieder installieren kรถnnen (auch wenn das sehr
@ -371,7 +371,7 @@ immer.
Sie sollten sich nicht genรถtigt fรผhlen plรถtzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
Argodejo ist dafรผr da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
Agordejo ist dafรผr da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
@ -390,7 +390,7 @@ aber trotzdem inhaltlich dazu gehรถrt: Open Broadcast Studio (OBS), Musikplayer,
und Grafikprogramme etc.
*Argodejo beinhaltet Funktionalitรคt, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
*Agordejo beinhaltet Funktionalitรคt, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
und Komplexitรคt ist unvermeidlich. Sie ist wie ein Wasserbett: Drรผckt man die auf der einen Seite
runter, muss etwas an einen anderen Stelle hochdrรผcken. Macht man ein programm "clean and lean",
und implementiert damit nur einen Teil des kompletten Arbeitsablaufs, dann kommt der fehlende Teil
@ -401,7 +401,7 @@ ist, und er es tun kann, dann soll er es machen.
Oder Abstรผrze: Technisch gesehen sind abstรผrzende Programme nicht das "Problem" des Session
Managers, aber sie sind Teil der Softwarewirklichkeit. Abstรผrze passieren jeden Tag und nun muss
man damit umgehen. Kann Argodejo die Arbeit vereinfachen und helfen den guten Zustand wieder
man damit umgehen. Kann Agordejo die Arbeit vereinfachen und helfen den guten Zustand wieder
herzustellen? Dann sollte das geschehen.
Session Management ist auรŸerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.
@ -411,30 +411,30 @@ Sessions รผber das Netzwerk zu verteilen.
== Installation und Start
Argodejo ist exklusiv fรผr Linux. Am besten installieren Sie Argodejo รผber deinen Paketmanager.
Agordejo ist exklusiv fรผr Linux. Am besten installieren Sie Agordejo รผber deinen Paketmanager.
Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitten sie ihre
Linuxdistribution Argodejo bereitzustellen.
Linuxdistribution Agordejo bereitzustellen.
Falls nicht in den Paketquellen vorhanden kann man Argodejo auch selbst "bauen".
Falls nicht in den Paketquellen vorhanden kann man Agordejo auch selbst "bauen".
.Abhรคngigkeiten*
* Eine Liste der Abhรคngigkeit befindet sich in der README.md
* Kompilieren und Installieren geht entweder mit einem Releasedownload oder mit der Git-Version:
** Laden Sie von https://www.laborejo.org/downloads die aktuelle Version herunter und entpacken Sie sie.
** `git clone https://git.laborejo.org/lss/argodejo.git`
** `git clone https://git.laborejo.org/lss/agordejo.git`
* Wechseln Sie in das neue Verzeichnis und benutzen diese Befehle:
*`./configure --prefix=/usr`
** Das Standardprefix is /usr/local
* `make`
* `sudo make install`
Nun ist das Programm durch `argodejo` in ihrem Terminal oder Programmstarter vorhanden.
Nun ist das Programm durch `agordejo` in ihrem Terminal oder Programmstarter vorhanden.
In der Datei README.md befinden sich weitere Mรถglichkeiten argodejo zu starten. Diese sind zum
In der Datei README.md befinden sich weitere Mรถglichkeiten agordejo zu starten. Diese sind zum
Musikmachen nicht praktikabel, aber nรผtzlich fรผr Tests und Entwicklung.
== Helfen und Entwicklung
Sie kรถnnen Argodejo auf viele Arten und Weisen helfen: Testen und Fehler melden, รผbersetzen, marketing,
Sie kรถnnen Agordejo auf viele Arten und Weisen helfen: Testen und Fehler melden, รผbersetzen, marketing,
anderen Nutzern helfen und schlieรŸlich programmieren.
=== Testen und Programmfehler
@ -452,7 +452,7 @@ Falls Sie an der Entwicklung interessiert sind, melden Sie sich am besten direkt
Kurzversion: clone git, programmieren, einen git-patch erstellen oder uns eine git URL zukommen lassen.
=== รœbersetzungen
Argodejo ist mit Hilfe der Qt-Toolchain sehr einfach zu รผbersetzen, ohne, dass man dafรผr Programmieren muss.
Agordejo ist mit Hilfe der Qt-Toolchain sehr einfach zu รผbersetzen, ohne, dass man dafรผr Programmieren muss.
Die einfachste Variante ist es einfach die Entwickler anzusprechen und sie werden die neue Sprache einrichten.
Hier ist dennoch die komplette Anleitung, um eine รœbersetzung komplett alleine anzufertigen und in
@ -482,6 +482,6 @@ Python Kentnisse nรถtig.
Um die neue รœbersetzung zu testen starten Sie das Programm, falls ihr System bereits auf diese
Sprache eingstellt ist.
Ansonsten starten Sie argodejo mit diesem Befehl, Sprachcode รคndern, vom Terminal aus:
Ansonsten starten Sie agordejo mit diesem Befehl, Sprachcode รคndern, vom Terminal aus:
* `LANGUAGE=de_DE.UTF-8 ./argodejo -V`
* `LANGUAGE=de_DE.UTF-8 ./agordejo -V`

60
documentation/german.part.adoc

@ -21,28 +21,28 @@ Echtzeit teilen, verfรผgen รผber synchronisierte Timelines und spielen im gleich
Was รผbrig bleibt ist die leidige Arbeit jedesmal alle Programme zu starten, die Projektdateien zu
laden, alle Audiokanรคle zu verbinden usw. Session Management im allgemeinen (z.B. extra
geschriebene Starter-Scriptdateien) und Argodejo im speziellen nehmen Ihnen diese Arbeit ab, oder
geschriebene Starter-Scriptdateien) und Agordejo im speziellen nehmen Ihnen diese Arbeit ab, oder
vereinfachen sie zumindest stark.
Im Gegensatz zum erwรคhnten selbstgeschriebenen Script mรผssen Sie sich nicht im Vorraus fรผr ein
Setup entscheiden, sondern alles wird automatisch verwaltet, solange Sie alles durch den Session
Manager Argodejo starten.
Manager Agordejo starten.
=== Anwendungsbeispiel
* Argodejo starten (Startmenรผ, Terminal etc.)
* Agordejo starten (Startmenรผ, Terminal etc.)
* Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten
* Der groรŸe Knopf: "Starte Neue Session"
* Nun bekommt man eine Auswahl an Programmen:
* Ein einfacher Klick mit der Maus startet ein Programm
* Ein weiterer Klick versteckt (oder zeigt anschlieรŸend) dessen grafische Oberflรคche
* Sollte das Programm abstรผrzen bekommt man das signalisiert und kann es neustarten.
* Audio- und Midiports kรถnnen nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Argodejo gespeichert.
* Audio- und Midiports kรถnnen nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.
* Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln
* Der Name der Session ist bisher einfach ein Datum. Durch Klick auf dieses kann man einen richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Knopf "Speichern und SchlieรŸen" wieder in die Sessionauswahl zurรผck
* Nun kรถnnte Argodejo geschlossen werden.
* Nun kรถnnte Agordejo geschlossen werden.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/NSM Sessions/Mein Lied`)
* Die Session kann weitergefรผhrt werden: Nach dem Klick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.
@ -58,7 +58,7 @@ Entscheidungen wie mรถglich zu treffen haben und so schnell wie mรถglich (mit de
eine alte Session starten oder eine neue erstellen kรถnnen.
Aus Stabilitรคtsgrรผnden werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Argodejos zusammenarbeiten.
korrekt mit dem Session Management Agordejos zusammenarbeiten.
Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie kรถnnen jederzeit hin- und herschalten.
@ -138,7 +138,7 @@ Jede Session verfรผgt รผber ein Kontextmenรผ (z.B. rechte Maustaste) mit weitere
eine Session umbennen, lรถschen (inkl. aller dazugehรถrigen Dateien auf der Festplatte!) und mehr.
Diese Funktionen sind gleichwertig zu ihrem Dateimanager. Falls Sie mรถchten, kรถnnen Sie auch
einfach die Sessionverzeichnisse selbst umbennen, verschieben oder lรถschen (sofern diese nicht
gerade geรถffnet ist). Dazu muss Argodejo nicht neugestartet werden, es reagiert selbst auf die
gerade geรถffnet ist). Dazu muss Agordejo nicht neugestartet werden, es reagiert selbst auf die
ร„nderungen.
Hier gibt es auch die Mรถglichkeit eine sogenannte "Lock"-Datei zu entfernen. Das ist eine Datei,
@ -177,7 +177,7 @@ Pro Programm gibt es folgende Informationen:
* Den Programmstatus (auf Englisch, da es sich um definierte Schlรผsselworte handelt).
* Stopped / Gestoppt, lรคuft nicht
* Ready / Lรคuft und Bereit
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstรผtzt. Argodejo kann nicht wissen, ob es bereits lรคuft oder nicht. Alles ist in Ordnung! :)
* Launch / Startet. Wenn das Programm hier stehen bleibt, aber funktioniert, handelt es sich um eins, dass nicht speziell den Sessionmodus unterstรผtzt. Agordejo kann nicht wissen, ob es bereits lรคuft oder nicht. Alles ist in Ordnung! :)
* Weitere Zustรคnde sind nur รœbergรคnge und meist nur sehr kurz zu sehen, z.B. Open / Lรคd gerade
* Sichtbarkeit (Ein Kreuz fรผr sichtbar, Leer fรผr unsichtbar)
* ร„nderungen - Gibt es momentan ungespeicherte ร„nderungen?
@ -208,13 +208,13 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menรผs zur Verfรผgung, di
* Abbrechen beendet die Session, ohne dass die Programme abspeichern
* Speichern Unter speichert die Session unter einem anderen Namen und schlieรŸt die laufende ohne abzuspeichern. Ab nun arbeitet man in der neuen Session.
* Client Hinzufรผgen bietet die Option ein beliebiges Programm hinzuzufรผgen, egal ob es in der Programmdatenbank ist, oder nicht.
* Es werden alle installierten Programme vorgeschlagen. Argodejo รผberprรผft diese nicht auf Sinnhaftigkeit fรผr eine Musik-Session, oder auch nur auf Lauffรคhigkeit. Sie finden hier `ls` wie auch `argodejo` selbst.
* Es werden alle installierten Programme vorgeschlagen. Agordejo รผberprรผft diese nicht auf Sinnhaftigkeit fรผr eine Musik-Session, oder auch nur auf Lauffรคhigkeit. Sie finden hier `ls` wie auch `agordejo` selbst.
== Programm-Datenbank
Argodejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
Agordejos Programmstarter basiert auf einer Programmdatenbank, die sich teilweise selbst erstellt,
teilweise von Hand eingepflegt wurde. Das bedeutet nichts anderes, als das alle installieren
Programme in ihrem System รผberprรผft werden (wie ein Startmenรผ) und Ihnen im Argodejo-Starter nur
Programme in ihrem System รผberprรผft werden (wie ein Startmenรผ) und Ihnen im Agordejo-Starter nur
das angeboten wird, was Sie auch tatsรคchlich installiert haben.
Beim ersten Start wird daher die Programmdatenbank erstellt. Je nach System kann dies einige
@ -222,7 +222,7 @@ Augenblicke bis einige Minuten dauern.
Wenn Sie Audio-Programme neu installieren, oder deinstallieren mรผssen Sie die Datenbank selbst
aktualisieren. Im Steuerungsmenรผ gibt es den Befehl. Programminstallationen sind sogar mรถglich
wรคhrend Argodejo lรคuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
wรคhrend Agordejo lรคuft (auch in einer Session). Nach einem DB-Update stehen Ihnen sofort alle
neuen Programme zur Verfรผgung.
Wenn Sie ein installiertes Programm nicht in unserer Liste sehen, aber von dem Sie sicher sind,
@ -250,10 +250,10 @@ Verzeichnis.
== Tray
Argodejo verfรผgt รผber ein Tray-Icon, sofern ihr Windowmanager das unterstรผzt. Ein Klick auf das
Trayicon zeigt oder versteckt Argodejo.
Agordejo verfรผgt รผber ein Tray-Icon, sofern ihr Windowmanager das unterstรผzt. Ein Klick auf das
Trayicon zeigt oder versteckt Agordejo.
SchlieรŸt man Argodejo รผber die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
SchlieรŸt man Agordejo รผber die normale Windowmanagerfunktion, etwa ein Klick auf das [X], wird das
Programm und die Session nicht beendet, sondern in den Tray minimiert.
Ein Rechtsklick auf das Icon bietet Schnellzugriff auf hรคufige Funktionen:
@ -262,7 +262,7 @@ Sie kรถnnen hier die zuletzt benutzen Sessions direkt starten.
Lรคuft bereits eine Session kรถnnen Sie speichern, abbrechen etc.
Argodejo kann hier auch komplett beendet werden.
Agordejo kann hier auch komplett beendet werden.
== Netzwerk-Sessions
@ -272,25 +272,25 @@ vorgesehen.
== Programmparameter
Als fortgeschrittener Benutzer kรถnnen Sie Argodejo im Terminal starten und dort einige Parameter
Als fortgeschrittener Benutzer kรถnnen Sie Agordejo im Terminal starten und dort einige Parameter
angeben. Fรผr eine vollstรคndige Liste benutzen Sie bitte den --help Parameter.
Eine Auswahl:
* `--session neuesAlbum/meinLied` startet direkt die angegebene Session.
* `--continue` startet die zuletzt benutzte Session
* `--hide` startet Argodejo als Trayicon.
* `--hide` startet Agordejo als Trayicon.
* `--url osc.udp://myhost.localdomain:14294/` verbindet sich zu diesem Server, falls vorhanden, oder startet den internen Session-Server unter dieser Adresse. Dies ist eine sehr technische Option und wird wahrscheinlich nicht benรถtigt.
* `--session-root /home/benutzer/produktion2020` setzt das Wurzelverzeichnis. Nur Sessions in diesem Verzeichnis werden angezeigt, alles wird dort gespeichert.
Die Kombination von `--continue` und `--hide` ergibt einen Modus, den viele Leute vom Session Management
erwarten: dort weiter machen wo man aufgehรถrt hat, ohne dass Extrafenster angezeigt werden.
Falls Ihr System รผber ein Startmenรผ verfรผgt finden Sie daher neben dem normalen Argodejo-Starter
auch eine "Argodejo Continue"-Verknรผpfung fรผr genau diesen Modus.
Falls Ihr System รผber ein Startmenรผ verfรผgt finden Sie daher neben dem normalen Agordejo-Starter
auch eine "Agordejo Continue"-Verknรผpfung fรผr genau diesen Modus.
== Verschiedenes / Erklรคrungen / FAQ
*Session Speichern und Beenden reagiert langsam*: Argodejo ist kein Einzelprogramm wie ein
*Session Speichern und Beenden reagiert langsam*: Agordejo ist kein Einzelprogramm wie ein
Office-Writer. Die teilnehmenden Programme in der Session sind auch keine Plugins. Wenn Sie die
Session beenden wird ein Signal an alle teilnehmenden Programme gesendet, dass sie speichern
sollen. Das kann ein paar Momente dauern, in denen Sie "live" mitverfolgen, wie die einzelnen
@ -298,7 +298,7 @@ Programme sich beenden und aus der Session verschwinden. Es ist alles in Ordnung
*Ich habe ein Programm hinzugefรผgt aber es speichert nicht mit der Session*:
Unterstรผtzt das Programm Session Management? Wenn nicht, kann Argodejo nichts tun.
Unterstรผtzt das Programm Session Management? Wenn nicht, kann Agordejo nichts tun.
Aber Sie kรถnnen die Programmentwickler bitten mit uns Kontakt aufzunehmen (info@laborejo.org)
und wir kรถnnen zusammen an der Unterstรผtzung arbeiten.
@ -308,14 +308,14 @@ Das tut uns leid. Eigentlich sind die Programme selbst schuld, aber auch wir sin
interessiert die Situation zu verbessen, indem wir in Zukunft zumindest eine Notlรถsung anbieten.
*Argodejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Argodejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
*Agordejo startet nicht mehr! Ich starte das Programm aber ich sehe nichts.*: Wahrscheinlich ist
Agordejo unsichtbar, weil Sie es aus dem Tray heraus beendet hatten. Ist es im Tray? Eigentlich
hรคtte ein kleines Nachrichtenfenster aufpoppen sollen. Falls in ihrem Window-Manager kein Tray
vorhanden ist sollte das Programm immer sichtbar sein. Bei besonderen Window-Managern (bei der
groรŸen Auswahl in Linux) kann es sein, dass die Tray-Erkennung nicht richtig funktioniert hat.
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/argodejo` zu lรถschen. Dabei werden KEINE
Notfallplan ist es `~/.config/LaborejoSoftwareSuite/agordejo` zu lรถschen. Dabei werden KEINE
Sessions gelรถscht, sondern nur lokale Einstellungen wie die Sichtbarkeit des Programmfensters. Beim
nรคchsten Start wird Argodejo sich verhalten wie beim allerersten.
nรคchsten Start wird Agordejo sich verhalten wie beim allerersten.
*JACK ist abgestรผrzt. Viele Programme hรคngen. Was tun um Datenverlust zu vermeiden?*:
@ -328,7 +328,7 @@ manuell im Dateimanager eine Kopie des Session-Verzeichnisses machen.
*Ein Programmupdate hat meine Session kaputtgemacht, weil es seine Dateien nicht mehr laden kann.*:
Das ist leider ein Problem, dass auch Argodejo nicht lรถsen kann. Es passiert mit LV2-Plugins ebenso
Das ist leider ein Problem, dass auch Agordejo nicht lรถsen kann. Es passiert mit LV2-Plugins ebenso
wie mit alle anderen Software, etwa Officeprogramme. Falls Sie befรผrchten, dass ein Programm in
Zukunft inkompatibel wird notieren Sie sich dessen Versionsnummer in den Session-Notizen, damit Sie
zumindest zur Not die alte Programmversion wieder installieren kรถnnen (auch wenn das sehr
@ -342,7 +342,7 @@ immer.
Sie sollten sich nicht genรถtigt fรผhlen plรถtzlich alles modular mit Einzelprogrammen zu machen, nur
weil Sie einen Session Manager benutzen.
Argodejo ist dafรผr da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
Agordejo ist dafรผr da, ihre Musikproduktion einfacher zu machen. Wenn es schneller und bequemer ist
alle Plugins und Effekte z.B. in einer einzelnen Carla-Instanz zu verwalten dann sollten Sie genau
das machen.
Wenn Sie prinzipiell alles in Ardour machen wollen, machen Sie das, aber starten Sie Ardour trotzdem
@ -361,7 +361,7 @@ aber trotzdem inhaltlich dazu gehรถrt: Open Broadcast Studio (OBS), Musikplayer,
und Grafikprogramme etc.
*Argodejo beinhaltet Funktionalitรคt, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
*Agordejo beinhaltet Funktionalitรคt, die nicht seine Aufgabe ist*: Musikproduktion ist sehr komplex
und Komplexitรคt ist unvermeidlich. Sie ist wie ein Wasserbett: Drรผckt man die auf der einen Seite
runter, muss etwas an einen anderen Stelle hochdrรผcken. Macht man ein programm "clean and lean",
und implementiert damit nur einen Teil des kompletten Arbeitsablaufs, dann kommt der fehlende Teil
@ -372,7 +372,7 @@ ist, und er es tun kann, dann soll er es machen.
Oder Abstรผrze: Technisch gesehen sind abstรผrzende Programme nicht das "Problem" des Session
Managers, aber sie sind Teil der Softwarewirklichkeit. Abstรผrze passieren jeden Tag und nun muss
man damit umgehen. Kann Argodejo die Arbeit vereinfachen und helfen den guten Zustand wieder
man damit umgehen. Kann Agordejo die Arbeit vereinfachen und helfen den guten Zustand wieder
herzustellen? Dann sollte das geschehen.
Session Management ist auรŸerdem eine Chance auch komplexe technische Szenarios zu vereinfachen, z.B.

2
documentation/index.adoc

@ -18,7 +18,7 @@ https://asciidoctor.org/docs/user-manual/
:nofooter:
== Argodejo Multi-Language Documentation
== Agordejo Multi-Language Documentation
image::logo.png["logo", 320, 180]
For program version 0.1

18
documentation/manpageinclude.h2m

@ -1,10 +1,10 @@
[name]
Argodejo - Music and audio production session manager based on NSM.
Agordejo - Music and audio production session manager based on NSM.
[usage]
Argodejo (Esperanto: 'place to set things up') is a music production session manager.
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.
@ -13,7 +13,7 @@ You can seamlessly change between two view modes to quickly start a few programs
control and a detailed overview.
Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.
@ -23,7 +23,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.
That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
@ -31,18 +31,18 @@ should provide a good user experience.
https://www.laborejo.org/bugs
[copyright]
Argodejo 0.1 - Copyright 2020
Agordejo 0.1 - Copyright 2020
Laborejo Software Suite
https://www.laborejo.org/
[examples]
Run argodejo. You are now in the Quick View mode. Press New Session and add programs through a
Run agordejo. You are now in the Quick View mode. Press New Session and add programs through a
single click on available program-icons. You can switch to the Full View mode via the tab to
get more options. Try right-clicking on many things to get context menus.
[see also]
The full documentation for Argodejo is maintained as a multi-lingual html site to your systems doc-dir.
The full documentation for Agordejo is maintained as a multi-lingual html site to your systems doc-dir.
For example:
xdg-open file:///usr/share/doc/argodejo/index.html
xdg-open file:///usr/share/doc/agordejo/index.html
The documentation can also be found online https://www.laborejo.org/documentation/argodejo
The documentation can also be found online https://www.laborejo.org/documentation/agordejo

2
documentation/nsm-data.1

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

90
documentation/out/english.html

@ -6,7 +6,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 2.0.10">
<meta name="author" content="Laborejo Software Suite">
<title>Argodejo</title>
<title>Agordejo</title>
<style>
/* Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
/* Uncomment @import statement to use as custom stylesheet */
@ -438,7 +438,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
</head>
<body class="article toc2 toc-left">
<div id="header">
<h1>Argodejo</h1>
<h1>Agordejo</h1>
<div class="details">
<span id="author" class="author">Laborejo Software Suite</span><br>
</div>
@ -500,7 +500,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<h2 id="_introduction">1. Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo (Esperanto: 'place to set things up') is a music production session manager.
<p>Agordejo (Esperanto: 'place to set things up') is a music production session manager.
It is used to start your programs, remember their (JACK) interconnections and make your life easier
in general.</p>
</div>
@ -509,7 +509,7 @@ in general.</p>
control and a detailed overview.</p>
</div>
<div class="paragraph">
<p>Argodejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
<p>Agordejo does not re-invent the wheel but instead uses the New-Session-Manager daemon and enhances
it with some tricks of its own, that always remain 100% compatible with the original sessions.</p>
</div>
<div class="paragraph">
@ -519,7 +519,7 @@ implemented, most prominently anything related to NSM over network. There is alw
break things when trying out corner cases and hacks.</p>
</div>
<div class="paragraph">
<p>That said, for single-computer sessions with just one daemon and one GUI at the same time Argodejo
<p>That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.</p>
</div>
</div>
@ -552,18 +552,18 @@ real time, have synchronized timelines and play in the same tempo.</p>
<div class="paragraph">
<p>What remains is the tedious work of always starting all programs, loading project files, connecting
audio channels etc. Session management in general (e.g. specifically written starter script files)
and Argodejo in particular do this work for you, or at the very least, greatly simplify it.</p>
and Agordejo in particular do this work for you, or at the very least, greatly simplify it.</p>
</div>
<div class="paragraph">
<p>In contrast to the self-written script mentioned above, you don&#8217;t have to decide in advance on a
setup, but everything is saved automatically as long as you manage everything through Argodejo.</p>
setup, but everything is saved automatically as long as you manage everything through Agordejo.</p>
</div>
<div class="sect2">
<h3 id="_example">2.1. Example</h3>
<div class="ulist">
<ul>
<li>
<p>Start Argodejo (Start menu, terminal etc.)</p>
<p>Start Agordejo (Start menu, terminal etc.)</p>
</li>
<li>
<p>You are now in the "Quick View" to start a session</p>
@ -584,7 +584,7 @@ setup, but everything is saved automatically as long as you manage everything th
<p>If the program crashes you get a warning and can restart it.</p>
</li>
<li>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Argodejo.</p>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.</p>
</li>
<li>
<p>To get more programs and advanced features you can switch to the tab "Full View</p>
@ -596,7 +596,7 @@ setup, but everything is saved automatically as long as you manage everything th
<p>If you are finished you can return to the session selection by pressing the button "Save and Close"</p>
</li>
<li>
<p>Now Argodejo could be closed itself.</p>
<p>Now Agordejo could be closed itself.</p>
</li>
<li>
<p>All stored data is in a single directory on the hard disk (<code>~/NSM Sessions/My Song</code>)</p>
@ -623,7 +623,7 @@ at least clicks).</p>
</div>
<div class="paragraph">
<p>For stability reasons, only programs are shown that are known to
work correctly with Argodejos session management.</p>
work correctly with Agordejos session management.</p>
</div>
<div class="paragraph">
<p>The Quick View is only a view. There is no technical difference to the full view and you can switch
@ -720,11 +720,11 @@ just a view, your data remains untouched.</p>
rename a session, delete it (including all associated files on the hard disk!) and more. These
functions are equivalent to your file manager. If you like, you can also use your file manager to
rename, move, or delete the session directories themselves (unless they are is currently open). You
don&#8217;t need to restart Argodejo to do this, it will respond to the changes while running.</p>
don&#8217;t need to restart Agordejo to do this, it will respond to the changes while running.</p>
</div>
<div class="paragraph">
<p>There is also the possibility to remove a so-called "lock" file. This is a file which is created
when the session starts and deleted when it ends. This tells Argodejo which session is currently
when the session starts and deleted when it ends. This tells Agordejo which session is currently
running. If a lock file exists, the session cannot be opened! This should not happen during normal
operation. But if a power failure or similar occurs in the middle of a session, the lock file may
remain, although obviously no session is opened. In this case, unlock the session manually by
@ -778,7 +778,7 @@ to hide its window if the program supports it. If not, nothing happens.</p>
<p>Ready, running</p>
</li>
<li>
<p>Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Argodejo cannot know if it is already running or not. Everything is fine! :)</p>
<p>Launch, If the status halts here but the programs works, it is one that does not specifically support session mode. Agordejo cannot know if it is already running or not. Everything is fine! :)</p>
</li>
<li>
<p>Other states are only transitions and usually only visible for a very short time, e.g. Open / Loading</p>
@ -844,7 +844,7 @@ lyrics, credits and sources from external Samples etc.</p>
<p>Add Client offers the option to add any program, whether it is in the program database or not.</p>
</li>
<li>
<p>Any installed programs are suggested. Argodejo doesn&#8217;t check them for usefulness for a music session, or even for runnability. You will find <code>ls</code> here as well as <code>argodejo</code> itself.</p>
<p>Any installed programs are suggested. Agordejo doesn&#8217;t check them for usefulness for a music session, or even for runnability. You will find <code>ls</code> here as well as <code>agordejo</code> itself.</p>
</li>
</ul>
</div>
@ -856,8 +856,8 @@ lyrics, credits and sources from external Samples etc.</p>
<h2 id="_program_database">5. Program-Database</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Argodejo will offer you only programs that are actually
<p>Agordejos launcher is based on a program database, which is partly self-generated, partly
maintained by hand. As in a start menu Agordejo will offer you only programs that are actually
installed on your system.</p>
</div>
<div class="paragraph">
@ -867,7 +867,7 @@ a few minutes.</p>
<div class="paragraph">
<p>If you are reinstalling or uninstalling audio programs, you will need to update the database via
the command in the control menu. Program installations and system changes are even possible while
Argodejo is running (even in a session). After a DB update you can immediately access all new
Agordejo is running (even in a session). After a DB update you can immediately access all new
programs.</p>
</div>
<div class="paragraph">
@ -902,11 +902,11 @@ search paths. One absolute directory path per line, no wildcards, trailing slash
<h2 id="_tray">6. Tray</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Argodejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Argodejo.</p>
<p>Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
hides Agordejo.</p>
</div>
<div class="paragraph">
<p>If you close Argodejo using the normal window manager function, such as a click on the [X], the
<p>If you close Agordejo using the normal window manager function, such as a click on the [X], the
program and the session is not terminated, but minimized to the tray.</p>
</div>
<div class="paragraph">
@ -919,7 +919,7 @@ program and the session is not terminated, but minimized to the tray.</p>
<p>If a session is already running you can save, cancel etc.</p>
</div>
<div class="paragraph">
<p>Argodejo can also be completely exited here.</p>
<p>Agordejo can also be completely exited here.</p>
</div>
</div>
</div>