Browse Source

Update manual, regenerate documentation and versioned files. Final changelog

master v0.4.0
Nils 8 months ago
parent
commit
562f630619
  1. 1
      CHANGELOG
  2. 21
      README.md
  3. 2
      configure
  4. 2
      desktop/desktop.desktop
  5. 27
      documentation/agordejo.1
  6. 122
      documentation/english.adoc
  7. 103
      documentation/english.part.adoc
  8. 114
      documentation/german.adoc
  9. 110
      documentation/german.part.adoc
  10. 4
      documentation/index.adoc
  11. 17
      documentation/manpageinclude.h2m
  12. 4
      documentation/nsm-data.1
  13. 203
      documentation/out/english.html
  14. 191
      documentation/out/german.html
  15. 2
      documentation/out/index.html
  16. 2375
      qtgui/resources.py
  17. BIN
      qtgui/resources/translations/de.qm
  18. 237
      qtgui/resources/translations/de.ts
  19. 234
      qtgui/resources/translations/it.ts

1
CHANGELOG

@ -11,6 +11,7 @@ Initial startup-check for old $HOME session root vs new XDG root.
Support nsmd 1.6.0 lockfiles. Older nsmd versions still work.
On startup give a choice to connect to an already running session (nsmd 1.6.0)
Remove internal program- and icon-database and replace with dynamic XDG based lookup.
pyxdg >=0.27 is now a dependency https://freedesktop.org/wiki/Software/pyxdg/
Add a nsm-data desktop file with nsm tags and "no-display", so it can be found by Agordejo.

21
README.md

@ -1,8 +1,8 @@
[//]: # (Generated 2022-01-15T19:48:12.408433. Changes belong into template/documentation/readme.template)
[//]: # (Generated 2022-04-15T00:39:29.279095. Changes belong into template/documentation/readme.template)
#Agordejo
Program version 0.3.1
Program version 0.4.0
![Screenshot](https://git.laborejo.org/lss/Agordejo/raw/branch/master/documentation/screenshot.png "Screenshot")
@ -14,18 +14,13 @@ It is used to start your programs, remember their (JACK) interconnections and ma
in general.
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.
You can create a session, or project, add programs to it and then use commands to save, start/stop,
hide/show all programs at once, or individually. At a later date you can then re-open
the session and continue where you left off.
This is a proof of concept version. It aims to show that session management with NSM can be quick
and convenient and make the user feel in control. Some functionality has not yet been
implemented, most prominently anything related to NSM over network. There is always the possibility to
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 Agordejo
should provide a good user experience.
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.
This README is just a short introduction. Consult the manual (see below) for more information.
@ -56,7 +51,7 @@ It is possible to clone a git repository.
* PyQt5 for Python 3
* DejaVu Sans Sarif TTF (Font) (recommended, but not technically necessary)
* nsmd: New Session Manager
* grep
* pyxdg: python-xdg
#### Build Dependencies
* Bash

2
configure

@ -1,6 +1,6 @@
#!/bin/bash
program=agordejo
version=0.3.1
version=0.4.0
#debugsym=true
prefix=/usr/local

2
desktop/desktop.desktop

@ -8,3 +8,5 @@ Terminal=false
StartupNotify=false
Version=1.0
Categories=AudioVideo;Audio;X-Recorders;X-Multitrack;X-Jack;
X-NSM-Capable=true
X-NSM-Exec=agordejo

27
documentation/agordejo.1

@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
.TH AGORDEJO "1" "January 2022" "Agordejo 0.3.1" "User Commands"
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
.TH AGORDEJO "1" "April 2022" "Agordejo 0.4.0" "User Commands"
.SH NAME
Agordejo - Music and audio production session manager based on NSM.
.SH DESCRIPTION
@ -7,7 +7,7 @@ usage: agordejo [\-h] [\-v] [\-V] [\-u URL] [\-\-nsm\-url URL] [\-l SESSION] [\-
.IP
[\-\-session\-root SESSIONROOT]
.PP
Agordejo \- Version 0.3.1 \- Copyright 2022 by Laborejo Software Suite \-
Agordejo \- Version 0.4.0 \- Copyright 2022 by Laborejo Software Suite \-
https://www.laborejo.org/agordejo
.SS "options:"
.TP
@ -44,8 +44,8 @@ Start GUI hidden in tray, only if tray available on
system.
.TP
\fB\-\-session\-root\fR SESSIONROOT
Root directory of all sessions. Defaults to '$HOME/NSM
Sessions'
Root directory of all sessions. Defaults to
$XDG_DATA_HOME/nsm/
.SH USAGE
Agordejo (Esperanto: 'place to set things up') is a music production session manager.
@ -53,18 +53,13 @@ It is used to start your programs, remember their (JACK) interconnections and ma
in general.
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.
You can create a session, or project, add programs to it and then use commands to save, start/stop,
hide/show all programs at once, or individually. At a later date you can then re-open
the session and continue where you left off.
This is a proof of concept version. It aims to show that session management with NSM can be quick
and convenient and make the user feel in control. Some functionality has not yet been
implemented, most prominently anything related to NSM over network. There is always the possibility to
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 Agordejo
should provide a good user experience.
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.
.SH EXAMPLES
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
@ -72,7 +67,7 @@ get more options. Try right-clicking on many things to get context menus.
.SH "REPORTING BUGS"
https://www.laborejo.org/bugs
.SH COPYRIGHT
Agordejo 0.3.1 - Copyright 2022
Agordejo 0.4.0 - Copyright 2022
Laborejo Software Suite
https://www.laborejo.org/
.SH "SEE ALSO"

122
documentation/english.adoc

@ -1,5 +1,5 @@
:Author: Laborejo Software Suite
:Version: 0.3.1
:Version: 0.4.0
:iconfont-remote!:
:!webfonts:
@ -25,7 +25,7 @@ https://asciidoctor.org/docs/user-manual/
= Agordejo
// Don't write in the empty line above line. It will be interpreted as author html tag
For program version 0.3.1
For program version 0.4.0
== Introduction
@ -35,18 +35,13 @@ It is used to start your programs, remember their (JACK) interconnections and ma
in general.
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.
This is a proof of concept version. It aims to show that session management with NSM can be quick
and convenient and make the user feel in control. Some functionality has not yet been
implemented, most prominently anything related to NSM over network. There is always the possibility to
break things when trying out corner cases and hacks.
You can create a session, or project, add programs to it and then use commands to save, start/stop,
hide/show all programs at once, or individually. At a later date you can then re-open
the session and continue where you left off.
That said, for single-computer sessions with just one daemon and one GUI at the same time Agordejo
should provide a good user experience.
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.
== Preamble
@ -78,82 +73,22 @@ setup, but everything is saved automatically as long as you manage everything th
=== Example
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Press the button "Quick New" on the left
* 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.
* A double single click with the mouse starts a program
* The program appears as entry in the other column and indicates that it is running
* To show it's GUI you probably need to double click on this new entry.
* The programs "jackpatch" and "nsm-data" were already added automatically.
* 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"
* The name of the session so far is simply a date. Through the menu you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by using the menus "Save and Close"
* 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.
"Quick View" is a good start. However, usually one would like to get into the full view, even if it
is only to start a program twice or to save manually.
== Quick View
The quick view is an environment reduced to the minimum. You, as a user, should have to make as few
decisions as possible and start an old session or create a new one as quickly as possible (with the
at least clicks).
For stability reasons, only programs are shown that are known to
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.
=== Selecting a Session
There are only two options here: Click on "Start New Session" to do so, or
select one of the existing sessions to resume it (if available).
* All stored data is in a single directory on the hard disk (`~/.local/share/nms/My Song`)
* The session can be resumed: After double clicking on the name, all programs start automatically and connect their JACK ports to among themselves.
=== In a Session
The name can be changed. We recommend a date in the form YYYY-MM-DD followed by a informative name.
Please note that the name change will only take effect (e.g. renaming the session directory on
disk) when you close the session.
Next, a larger text field is available for notes. Write what you want. TODO lists, lyrics, credits
and sources of external samples etc.
Programs are symbolized by icons. A mouse click starts the program (which can take a while, we have
no influence on that). The status of the program is indicated by a symbol: The "Play" symbol for
the running program, the eye means "program window hidden", the "Power On/Off" symbol means that
the program has been terminated (or crashed).
If the program supports it, a running program window can be hidden. Synthesizers, once set up, do
not have to be permanently visible. Just click on the program icon again. Either nothing happens
(the program does not support it) or the window will hide. Another click on a hidden window shows
it again. Every program itself is responsible for whether it saves its window state. Also, some
programs already start hidden.
There is *no* way to end or remove a program in this view. To do this, switch to the full view or
use the close function of the program itself.
There is also *no* possibility to start a program multiple times, e.g. one synthesizer per
track. If you want to start multiple program instances through the full view times you can still
use the quick view to manage the general session, but it is not defined which program instance a
click on the icon (e.g. to hide) affects. Multiple instances are a clear indicator that you are
ready for the full view.
== Full Explanation
As you'll eventually discover, not *all* available programs are in the list, and there there is
also no possibility to start programs that would work well in a session (e.g. a tuner), but are not
explicitly written for it, e.g. do not report their status. It is better to manage these programs
in full view.
If, unfortunately, a program has crashed, you can only restart it and hope its automatic saving
worked. Good luck.
== Full View
Some concepts have already been explained in the chapter "Quick View". It is expected that you have
read this.
=== Selecting a Session
@ -166,7 +101,7 @@ space. The displayed disk space usage is not the actual one, but includes the si
symlink-targets. Only when you archive the session or replace the links with real files the number
becomes correct.
Finally, the directory in which the files are actually stored is also given.
Finally, the directory in which the files are actually stored is also given.
Sessions represent the directory tree. A session is always a "leaf" and cannot include subsessions.
When creating or renaming sessions, you can also arrange them in the tree by using the usual slash
@ -182,13 +117,6 @@ functions are equivalent to your file manager. If you like, you can also use you
rename, move, or delete the session directories themselves (unless they are is currently open). You
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 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
deleting the lock file.
Click on "New session" to create one. In contrast to the quick view, you must enter the name
directly . As mentioned above, you can use the directory tree. In addition, there are several
(almost obligatory) programs suggested to start with. Normally one should accept all suggestions.
@ -198,8 +126,8 @@ A double click on an existing session (or the "Load Selected" button) does just
=== In a Session
The full view is divided into three areas: Program starter, programs in the current session
and the session notes. There is also a dynamic menu.
The view is divided into three areas: Program starter, programs in the current session
and the session notes. There is also a dynamic menu.
On the left side you see the program starter. A double-click starts a program instance in this
session. You can also start a program more than once. For available programs please refer to the
@ -214,7 +142,7 @@ The following information is available per program:
* The name (possibly with icon)
* A "label" that programs can use freely (e.g. Fluajho shows the loaded .sf2 here)
* The program status
* 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. Agordejo cannot know if it is already running or not. Everything is fine! :)
@ -243,7 +171,7 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Save instructs all programs to save, the session continues to run
* Save and Close ends the session, after all programs saved
* 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.
* Add Client offers the option to add any program, whether it is in the program database or not.
* 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.
@ -298,12 +226,6 @@ If a session is already running you can save, cancel etc.
Agordejo can also be completely exited here.
== Network Sessions
The functionality to distribute sessions over the local network is planned for a later program
version.
== Program parameters
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a

103
documentation/english.part.adoc

@ -27,82 +27,22 @@ setup, but everything is saved automatically as long as you manage everything th
=== Example
* Start Agordejo (Start menu, terminal etc.)
* You are now in the "Quick View" to start a session
* Press the big button "Start New Session"
* Press the button "Quick New" on the left
* 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.
* A double single click with the mouse starts a program
* The program appears as entry in the other column and indicates that it is running
* To show it's GUI you probably need to double click on this new entry.
* The programs "jackpatch" and "nsm-data" were already added automatically.
* 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"
* The name of the session so far is simply a date. Through the menu you can enter a real name. Like "My song"
* If you are finished you can return to the session selection by using the menus "Save and Close"
* 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.
* All stored data is in a single directory on the hard disk (`~/.local/share/nms/My Song`)
* The session can be resumed: After double clicking on the name, all programs start automatically and connect their JACK ports to among themselves.
"Quick View" is a good start. However, usually one would like to get into the full view, even if it
is only to start a program twice or to save manually.
== Quick View
== Full Explanation
The quick view is an environment reduced to the minimum. You, as a user, should have to make as few
decisions as possible and start an old session or create a new one as quickly as possible (with the
at least clicks).
For stability reasons, only programs are shown that are known to
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.
=== Selecting a Session
There are only two options here: Click on "Start New Session" to do so, or
select one of the existing sessions to resume it (if available).
=== In a Session
The name can be changed. We recommend a date in the form YYYY-MM-DD followed by a informative name.
Please note that the name change will only take effect (e.g. renaming the session directory on
disk) when you close the session.
Next, a larger text field is available for notes. Write what you want. TODO lists, lyrics, credits
and sources of external samples etc.
Programs are symbolized by icons. A mouse click starts the program (which can take a while, we have
no influence on that). The status of the program is indicated by a symbol: The "Play" symbol for
the running program, the eye means "program window hidden", the "Power On/Off" symbol means that
the program has been terminated (or crashed).
If the program supports it, a running program window can be hidden. Synthesizers, once set up, do
not have to be permanently visible. Just click on the program icon again. Either nothing happens
(the program does not support it) or the window will hide. Another click on a hidden window shows
it again. Every program itself is responsible for whether it saves its window state. Also, some
programs already start hidden.
There is *no* way to end or remove a program in this view. To do this, switch to the full view or
use the close function of the program itself.
There is also *no* possibility to start a program multiple times, e.g. one synthesizer per
track. If you want to start multiple program instances through the full view times you can still
use the quick view to manage the general session, but it is not defined which program instance a
click on the icon (e.g. to hide) affects. Multiple instances are a clear indicator that you are
ready for the full view.
As you'll eventually discover, not *all* available programs are in the list, and there there is
also no possibility to start programs that would work well in a session (e.g. a tuner), but are not
explicitly written for it, e.g. do not report their status. It is better to manage these programs
in full view.
If, unfortunately, a program has crashed, you can only restart it and hope its automatic saving
worked. Good luck.
== Full View
Some concepts have already been explained in the chapter "Quick View". It is expected that you have
read this.
=== Selecting a Session
@ -115,7 +55,7 @@ space. The displayed disk space usage is not the actual one, but includes the si
symlink-targets. Only when you archive the session or replace the links with real files the number
becomes correct.
Finally, the directory in which the files are actually stored is also given.
Finally, the directory in which the files are actually stored is also given.
Sessions represent the directory tree. A session is always a "leaf" and cannot include subsessions.
When creating or renaming sessions, you can also arrange them in the tree by using the usual slash
@ -131,13 +71,6 @@ functions are equivalent to your file manager. If you like, you can also use you
rename, move, or delete the session directories themselves (unless they are is currently open). You
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 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
deleting the lock file.
Click on "New session" to create one. In contrast to the quick view, you must enter the name
directly . As mentioned above, you can use the directory tree. In addition, there are several
(almost obligatory) programs suggested to start with. Normally one should accept all suggestions.
@ -147,8 +80,8 @@ A double click on an existing session (or the "Load Selected" button) does just
=== In a Session
The full view is divided into three areas: Program starter, programs in the current session
and the session notes. There is also a dynamic menu.
The view is divided into three areas: Program starter, programs in the current session
and the session notes. There is also a dynamic menu.
On the left side you see the program starter. A double-click starts a program instance in this
session. You can also start a program more than once. For available programs please refer to the
@ -163,7 +96,7 @@ The following information is available per program:
* The name (possibly with icon)
* A "label" that programs can use freely (e.g. Fluajho shows the loaded .sf2 here)
* The program status
* 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. Agordejo cannot know if it is already running or not. Everything is fine! :)
@ -192,7 +125,7 @@ In contrast to the quick view, full mode offers menus, which can also be accesse
* Save instructs all programs to save, the session continues to run
* Save and Close ends the session, after all programs saved
* 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.
* Add Client offers the option to add any program, whether it is in the program database or not.
* 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.
@ -247,12 +180,6 @@ If a session is already running you can save, cancel etc.
Agordejo can also be completely exited here.
== Network Sessions
The functionality to distribute sessions over the local network is planned for a later program
version.
== Program parameters
As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a

114
documentation/german.adoc

@ -1,5 +1,5 @@
:Author: Laborejo Software Suite
:Version: 0.3.1
:Version: 0.4.0
:iconfont-remote!:
:!webfonts:
@ -25,7 +25,7 @@ https://asciidoctor.org/docs/user-manual/
= Agordejo
// Don't write in the empty line above line. It will be interpreted as author html tag
Für Programmversion 0.3.1
Für Programmversion 0.4.0
== Präambel
@ -33,7 +33,7 @@ Session Management führt zur Vereinfachung von Arbeitsabläufen, Übersicht und
Programme und Daten und eine gehörige Portion positive Bequemlichkeit :)
Kein Programm existiert für sich alleine, denn kein Programm kann alles leisten, was für heutige
Musikproduktion nötig ist.
Musikproduktion nötig ist.
Direkt ersichtlich ist das in einer JACK Umgebung, die prinzipiell modular ist: Verschiedene
Programme erfüllen verschiedene Zwecke und "sprechen" miteinander, indem sie sich Daten schicken.
@ -60,86 +60,22 @@ Manager Agordejo starten.
=== Anwendungsbeispiel
* 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"
* Agordejo starten (Startmenü, Terminal etc.)
* Den Knopf auf der linken Seite drücken: "Schnellstart Neu"
* 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.
* Ein Doppelklick mit der Maus startet ein Programm
* Das Programm erscheint in der anderen Spalte und zeigt an, dass es läuft.
* Die GUI des Programms erscheint evtl. erst wenn man auf den neuen Eintrag doppelklickt.
* Die Programme "jackpatch" und "nsm-data" wurden schon automatisch hinzugefügt
* 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
* Der Name der Session ist bisher einfach ein Datum. Im Menü kann man richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Menüeintrag "Speichern und Schließen" wieder in die Sessionauswahl zurück
* 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.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/.local/share/nms/Mein Lied`)
* Die Session kann weitergeführt werden: Nach dem Doppelklick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.
Die "Schnelle Ansicht" ist ein guter Einstieg. Üblicherweise möchte man jedoch bald in die volle
Ansicht wechseln, und sei es nur um ein Programm zwei mal zu starten oder um zwischendurch manuell
zu speichern.
== Die Schnelle Ansicht
Die Schnelle Ansicht ist eine aufs Minimum reduzierte Umgebung. Sie, als Benutzer, sollen so wenig
Entscheidungen wie möglich zu treffen haben und so schnell wie möglich (mit den wenigstens Klicks)
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 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.
=== Session Auswählen
Hier gibt es nur zwei Möglichkeiten: Klicken Sie auf "Starte Neue Session" um dies zu tun, oder
wählen Sie eine der bestehenden Sessions aus um diese fortzuführen (sofern vorhanden).
=== In einer Session
Der Name kann geändert werden. Wir empfehlen ein Datum in der Form YYYY-MM-DD gefolgt von einem
aussagekräftigen Namen. Bitte beachten Sie, dass die Namensänderung erst wirksam wird (z.B. in Form
des Sessionvereichnisses auf der Platte) wenn Sie die Session schließen.
Als nächstes steht ein größeres Textfeld für Notizen zur Verfügung. Schreiben Sie was Sie möchten.
TODO-Listen, Liedtexte, Credits und Quellen von externen Samples etc.
Programme werden durch Icons symbolisiert. Ein Mausklick startet das Programm (das kann einen
Moment dauern, darauf haben wir keinen Einfluss). Der Status des Programmes wird durch ein Symbol
dargestellt: Das "Play"-Symbol für das laufende Programm, ein Auge bedeutet "Programmfenster
versteckt", das "Power On/Off"-Symbol bedeutet, dass Programm wurde beendet (oder Absturz).
Falls das Programm es unterstützt kann ein laufendes Programmfenster versteckt werden. z.B. ein
Synthesizer, einmal eingerichtet, muss nicht permanent zu sehen sein. Klicken Sie einfach erneut
auf das Programmicon. Entweder passiert nichts (das Programm unterstützt es nicht) oder es wird
versteckt. Ein weiterer Klick auf ein versteckes Fenster zeigt es wieder. Jedes Programm ist selbst
dafür verantwortlich ob es seinen Fensterzustand speichert. Manche Programme starten bereits
versteckt.
Es gibt *keine* Möglichkeit ein Programm in dieser Ansicht zu beenden. Wechseln Sie hierzu in die
volle Ansicht oder benutzen Sie die Schließenfunktion des Programmes selbst.
Es gibt auch *keine* Möglichkeit ein Programm mehrfach zu starten, z.B. für einen Synthesizer pro
Spur. Wechseln sie hierzu in die volle Ansicht. Wenn Sie Programme durch die volle Ansicht mehrfach
gestartet haben können Sie weiterhin die schnelle Ansicht benutzen um die Session zu verwalten,
allerdings ist nicht definiert auf welche Programminstanz sich ein Klick auf das Programmicon (z.B.
zum Verstecken) auswirkt. Mehrere Instanzen sind ein klares Zeichen dafür, dass Sie bereit für die
volle Ansicht sind.
Wie Sie irgendwann feststellen werden sind nicht *alle* verfügbaren Programme in der Liste, und es
gibt auch keine Möglichkeit Programme zu starten die zwar gut in einer Session funktionieren (z.B.
ein Stimmgerät), aber nicht explizit dafür geschrieben sind, z.B. ihren Status nicht zurückmelden.
Diese Programme sollten Sie besser in der vollen Ansicht verwalten.
Ist ein Programm leider abgestürzt können Sie es nur neu starten und auf dessen automatische
Speicherung hoffen. Viel Glück.
== Die Volle Ansicht
Einige Konzepte wurde bereits im Kapitel "Die Schnelle Ansicht" erklärt. Es wird vorrausgesetzt,
dass Sie dieses gelesen haben.
== Vollständige Erklärung
=== Session Auswählen
@ -152,7 +88,7 @@ Session gelinkt, und nicht kopiert, um Speicherplatz zu sparen. Der angezeigte S
ist nicht der tatsächliche Verbrauch, sondern beinhaltet die Größen der Symlinks. Erst wenn Sie die
Session archivieren oder die Links durch reale Dateien ersetzen stimmt die angezeigte Zahl.
Schließlich wird auch das Verzeichnis angegeben, in dem die Dateien tatsächlich gespeichert sind.
Schließlich wird auch das Verzeichnis angegeben, in dem die Dateien tatsächlich gespeichert sind.
Sessions stellen den Verzeichnisbaum dar. Eine Session ist immer ein "Blatt" und kann keine
Subsessions enthalten. Sie können beim Anlegen oder Umbenennen die Sessions auch im Baum anordnen
@ -170,13 +106,6 @@ einfach die Sessionverzeichnisse selbst umbennen, verschieben oder löschen (sof
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,
die angelegt wird sobald die Session startet und gelöscht wenn beendet. Damit weiß das Programm,
welche Session gerade läuft. Ist eine Lockdatei vorhanden, kann die Session nicht geöffnet werden!
Das sollte im normalen Betrieb nicht vorkommen. Falls aber ein Stromausfall o.ä. mitten in einer
Session passiert ist kann die Lockdatei übrig bleiben, obwohl offensichtlich keine Session geöffnet
ist. In diesem Fall entsperren Sie die Session hierdurch manuell.
Klicken Sie auf "Neue Session" um diese anzulegen. Im Gegensatz zur schnellen Ansicht müssen Sie
hier den Namen direkt eingeben. Wie oben erwäht können Sie dazu den Verzeichnisbaum benutzen.
Darüberhinaus wird angeboten verschiedene (fast schon obligatorische) Programme direkt
@ -187,8 +116,8 @@ Ein Doppelklick auf eine existierende Session (oder der Knopf "Lade Ausgewählte
=== In einer Session
Die volle Ansicht ist in drei Bereiche eingeteilt: Programmstarter, Programme in der laufenden Session
und die Session-Notizen. Dazu gibt es ein dynamisches Menü.
Die Ansicht ist in drei Bereiche eingeteilt: Programmstarter, Programme in der laufenden Session
und die Session-Notizen. Dazu gibt es ein dynamisches Menü.
Auf der linken Seite sehen die den Programmstarter. Ein Doppelklick startet eine Programminstanz in
der Session. Sie können ein Programm auch mehrmals starten. Welche Programme zur Verfügung stehen
@ -203,7 +132,7 @@ Pro Programm gibt es folgende Informationen:
* Der Name (evtl. mit Icon)
* Ein "Label", das Programme frei benutzen können (z.B. zeigt Fluajho hier das geladene .sf2 an)
* 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
* 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. Agordejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
@ -234,7 +163,7 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menüs zur Verfügung, di
* Speichern weist alle Programme an zu speichern, die Session läuft weiter
* Speichern und Schließen beendet die Session, vorher speichern alle Programme noch einmal ab
* 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.
* 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. 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.
@ -293,11 +222,6 @@ Läuft bereits eine Session können Sie speichern, abbrechen etc.
Agordejo kann hier auch komplett beendet werden.
== Netzwerk-Sessions
Die Funktionalität Sessions im lokalen Netzwerk zu verteilen ist für eine spätere Programmversion
vorgesehen.
== Programmparameter

110
documentation/german.part.adoc

@ -4,7 +4,7 @@ Session Management führt zur Vereinfachung von Arbeitsabläufen, Übersicht und
Programme und Daten und eine gehörige Portion positive Bequemlichkeit :)
Kein Programm existiert für sich alleine, denn kein Programm kann alles leisten, was für heutige
Musikproduktion nötig ist.
Musikproduktion nötig ist.
Direkt ersichtlich ist das in einer JACK Umgebung, die prinzipiell modular ist: Verschiedene
Programme erfüllen verschiedene Zwecke und "sprechen" miteinander, indem sie sich Daten schicken.
@ -31,86 +31,22 @@ Manager Agordejo starten.
=== Anwendungsbeispiel
* 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"
* Agordejo starten (Startmenü, Terminal etc.)
* Den Knopf auf der linken Seite drücken: "Schnellstart Neu"
* 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.
* Ein Doppelklick mit der Maus startet ein Programm
* Das Programm erscheint in der anderen Spalte und zeigt an, dass es läuft.
* Die GUI des Programms erscheint evtl. erst wenn man auf den neuen Eintrag doppelklickt.
* Die Programme "jackpatch" und "nsm-data" wurden schon automatisch hinzugefügt
* 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
* Der Name der Session ist bisher einfach ein Datum. Im Menü kann man richtigen Namen eingeben. Etwa "Mein Lied"
* Ist man soweit fertig kommt man durch den Menüeintrag "Speichern und Schließen" wieder in die Sessionauswahl zurück
* 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.
* Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (`~/.local/share/nms/Mein Lied`)
* Die Session kann weitergeführt werden: Nach dem Doppelklick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.
Die "Schnelle Ansicht" ist ein guter Einstieg. Üblicherweise möchte man jedoch bald in die volle
Ansicht wechseln, und sei es nur um ein Programm zwei mal zu starten oder um zwischendurch manuell
zu speichern.
== Die Schnelle Ansicht
Die Schnelle Ansicht ist eine aufs Minimum reduzierte Umgebung. Sie, als Benutzer, sollen so wenig
Entscheidungen wie möglich zu treffen haben und so schnell wie möglich (mit den wenigstens Klicks)
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 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.
=== Session Auswählen
Hier gibt es nur zwei Möglichkeiten: Klicken Sie auf "Starte Neue Session" um dies zu tun, oder
wählen Sie eine der bestehenden Sessions aus um diese fortzuführen (sofern vorhanden).
=== In einer Session
Der Name kann geändert werden. Wir empfehlen ein Datum in der Form YYYY-MM-DD gefolgt von einem
aussagekräftigen Namen. Bitte beachten Sie, dass die Namensänderung erst wirksam wird (z.B. in Form
des Sessionvereichnisses auf der Platte) wenn Sie die Session schließen.
Als nächstes steht ein größeres Textfeld für Notizen zur Verfügung. Schreiben Sie was Sie möchten.
TODO-Listen, Liedtexte, Credits und Quellen von externen Samples etc.
Programme werden durch Icons symbolisiert. Ein Mausklick startet das Programm (das kann einen
Moment dauern, darauf haben wir keinen Einfluss). Der Status des Programmes wird durch ein Symbol
dargestellt: Das "Play"-Symbol für das laufende Programm, ein Auge bedeutet "Programmfenster
versteckt", das "Power On/Off"-Symbol bedeutet, dass Programm wurde beendet (oder Absturz).
Falls das Programm es unterstützt kann ein laufendes Programmfenster versteckt werden. z.B. ein
Synthesizer, einmal eingerichtet, muss nicht permanent zu sehen sein. Klicken Sie einfach erneut
auf das Programmicon. Entweder passiert nichts (das Programm unterstützt es nicht) oder es wird
versteckt. Ein weiterer Klick auf ein versteckes Fenster zeigt es wieder. Jedes Programm ist selbst
dafür verantwortlich ob es seinen Fensterzustand speichert. Manche Programme starten bereits
versteckt.
Es gibt *keine* Möglichkeit ein Programm in dieser Ansicht zu beenden. Wechseln Sie hierzu in die
volle Ansicht oder benutzen Sie die Schließenfunktion des Programmes selbst.
Es gibt auch *keine* Möglichkeit ein Programm mehrfach zu starten, z.B. für einen Synthesizer pro
Spur. Wechseln sie hierzu in die volle Ansicht. Wenn Sie Programme durch die volle Ansicht mehrfach
gestartet haben können Sie weiterhin die schnelle Ansicht benutzen um die Session zu verwalten,
allerdings ist nicht definiert auf welche Programminstanz sich ein Klick auf das Programmicon (z.B.
zum Verstecken) auswirkt. Mehrere Instanzen sind ein klares Zeichen dafür, dass Sie bereit für die
volle Ansicht sind.
Wie Sie irgendwann feststellen werden sind nicht *alle* verfügbaren Programme in der Liste, und es
gibt auch keine Möglichkeit Programme zu starten die zwar gut in einer Session funktionieren (z.B.
ein Stimmgerät), aber nicht explizit dafür geschrieben sind, z.B. ihren Status nicht zurückmelden.
Diese Programme sollten Sie besser in der vollen Ansicht verwalten.
Ist ein Programm leider abgestürzt können Sie es nur neu starten und auf dessen automatische
Speicherung hoffen. Viel Glück.
== Die Volle Ansicht
Einige Konzepte wurde bereits im Kapitel "Die Schnelle Ansicht" erklärt. Es wird vorrausgesetzt,
dass Sie dieses gelesen haben.
== Vollständige Erklärung
=== Session Auswählen
@ -123,7 +59,7 @@ Session gelinkt, und nicht kopiert, um Speicherplatz zu sparen. Der angezeigte S
ist nicht der tatsächliche Verbrauch, sondern beinhaltet die Größen der Symlinks. Erst wenn Sie die
Session archivieren oder die Links durch reale Dateien ersetzen stimmt die angezeigte Zahl.
Schließlich wird auch das Verzeichnis angegeben, in dem die Dateien tatsächlich gespeichert sind.
Schließlich wird auch das Verzeichnis angegeben, in dem die Dateien tatsächlich gespeichert sind.
Sessions stellen den Verzeichnisbaum dar. Eine Session ist immer ein "Blatt" und kann keine
Subsessions enthalten. Sie können beim Anlegen oder Umbenennen die Sessions auch im Baum anordnen
@ -141,13 +77,6 @@ einfach die Sessionverzeichnisse selbst umbennen, verschieben oder löschen (sof
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,
die angelegt wird sobald die Session startet und gelöscht wenn beendet. Damit weiß das Programm,
welche Session gerade läuft. Ist eine Lockdatei vorhanden, kann die Session nicht geöffnet werden!
Das sollte im normalen Betrieb nicht vorkommen. Falls aber ein Stromausfall o.ä. mitten in einer
Session passiert ist kann die Lockdatei übrig bleiben, obwohl offensichtlich keine Session geöffnet
ist. In diesem Fall entsperren Sie die Session hierdurch manuell.
Klicken Sie auf "Neue Session" um diese anzulegen. Im Gegensatz zur schnellen Ansicht müssen Sie
hier den Namen direkt eingeben. Wie oben erwäht können Sie dazu den Verzeichnisbaum benutzen.
Darüberhinaus wird angeboten verschiedene (fast schon obligatorische) Programme direkt
@ -158,8 +87,8 @@ Ein Doppelklick auf eine existierende Session (oder der Knopf "Lade Ausgewählte
=== In einer Session
Die volle Ansicht ist in drei Bereiche eingeteilt: Programmstarter, Programme in der laufenden Session
und die Session-Notizen. Dazu gibt es ein dynamisches Menü.
Die Ansicht ist in drei Bereiche eingeteilt: Programmstarter, Programme in der laufenden Session
und die Session-Notizen. Dazu gibt es ein dynamisches Menü.
Auf der linken Seite sehen die den Programmstarter. Ein Doppelklick startet eine Programminstanz in
der Session. Sie können ein Programm auch mehrmals starten. Welche Programme zur Verfügung stehen
@ -174,7 +103,7 @@ Pro Programm gibt es folgende Informationen:
* Der Name (evtl. mit Icon)
* Ein "Label", das Programme frei benutzen können (z.B. zeigt Fluajho hier das geladene .sf2 an)
* 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
* 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. Agordejo kann nicht wissen, ob es bereits läuft oder nicht. Alles ist in Ordnung! :)
@ -205,7 +134,7 @@ Im Gegensatz zur schnellen Ansicht stehen hier weitere Menüs zur Verfügung, di
* Speichern weist alle Programme an zu speichern, die Session läuft weiter
* Speichern und Schließen beendet die Session, vorher speichern alle Programme noch einmal ab
* 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.
* 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. 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.
@ -264,11 +193,6 @@ Läuft bereits eine Session können Sie speichern, abbrechen etc.
Agordejo kann hier auch komplett beendet werden.
== Netzwerk-Sessions
Die Funktionalität Sessions im lokalen Netzwerk zu verteilen ist für eine spätere Programmversion
vorgesehen.
== Programmparameter

4
documentation/index.adoc

@ -1,5 +1,5 @@
:Author: Laborejo Software Suite
:Version: 0.3.1
:Version: 0.4.0
:iconfont-remote!:
:!webfonts:
@ -21,7 +21,7 @@ https://asciidoctor.org/docs/user-manual/
== Agordejo Multi-Language Documentation
image::logo.png["logo", 320, 180]
For program version 0.3.1
For program version 0.4.0
This site is part of the https://www.laborejo.org[Laborejo Software Suite]

17
documentation/manpageinclude.h2m

@ -9,25 +9,20 @@ It is used to start your programs, remember their (JACK) interconnections and ma
in general.
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.
You can create a session, or project, add programs to it and then use commands to save, start/stop,
hide/show all programs at once, or individually. At a later date you can then re-open
the session and continue where you left off.
This is a proof of concept version. It aims to show that session management with NSM can be quick
and convenient and make the user feel in control. Some functionality has not yet been
implemented, most prominently anything related to NSM over network. There is always the possibility to
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 Agordejo
should provide a good user experience.
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.
[Reporting bugs]
https://www.laborejo.org/bugs
[copyright]
Agordejo 0.3.1 - Copyright 2022
Agordejo 0.4.0 - Copyright 2022
Laborejo Software Suite
https://www.laborejo.org/

4
documentation/nsm-data.1

@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
.TH NSM-DATA "1" "January 2022" "nsm-data 1.1" "User Commands"
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
.TH NSM-DATA "1" "April 2022" "nsm-data 1.1" "User Commands"
.SH NAME
nsm-data \- manual page for nsm-data 1.1
.SH DESCRIPTION

203
documentation/out/english.html

@ -451,38 +451,31 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<li><a href="#_example">2.1. Example</a></li>
</ul>
</li>
<li><a href="#_quick_view">3. Quick View</a>
<li><a href="#_full_explanation">3. Full Explanation</a>
<ul class="sectlevel2">
<li><a href="#_selecting_a_session">3.1. Selecting a Session</a></li>
<li><a href="#_in_a_session">3.2. In a Session</a></li>
</ul>
</li>
<li><a href="#_full_view">4. Full View</a>
<ul class="sectlevel2">
<li><a href="#_selecting_a_session_2">4.1. Selecting a Session</a></li>
<li><a href="#_in_a_session_2">4.2. In a Session</a>
<li><a href="#_in_a_session">3.2. In a Session</a>
<ul class="sectlevel3">
<li><a href="#_running_programs">4.2.1. Running Programs</a></li>
<li><a href="#_the_session_menu">4.2.2. The Session Menu</a></li>
<li><a href="#_running_programs">3.2.1. Running Programs</a></li>
<li><a href="#_the_session_menu">3.2.2. The Session Menu</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#_program_database">5. Program-Database</a>
<li><a href="#_program_database">4. Program-Database</a>
<ul class="sectlevel2">
<li><a href="#_for_advanced_users">5.1. For advanced users</a></li>
<li><a href="#_for_advanced_users">4.1. For advanced users</a></li>
</ul>
</li>
<li><a href="#_tray">6. Tray</a></li>
<li><a href="#_network_sessions">7. Network Sessions</a></li>
<li><a href="#_program_parameters">8. Program parameters</a></li>
<li><a href="#_miscellaneous_explanations_faq">9. Miscellaneous / Explanations / FAQ</a></li>
<li><a href="#_installation_and_start">10. Installation and Start</a></li>
<li><a href="#_help_and_development">11. Help and Development</a>
<li><a href="#_tray">5. Tray</a></li>
<li><a href="#_program_parameters">6. Program parameters</a></li>
<li><a href="#_miscellaneous_explanations_faq">7. Miscellaneous / Explanations / FAQ</a></li>
<li><a href="#_installation_and_start">8. Installation and Start</a></li>
<li><a href="#_help_and_development">9. Help and Development</a>
<ul class="sectlevel2">
<li><a href="#_testing_and_reporting_errors">11.1. Testing and Reporting Errors</a></li>
<li><a href="#_programming">11.2. Programming</a></li>
<li><a href="#_translations">11.3. Translations</a></li>
<li><a href="#_testing_and_reporting_errors">9.1. Testing and Reporting Errors</a></li>
<li><a href="#_programming">9.2. Programming</a></li>
<li><a href="#_translations">9.3. Translations</a></li>
</ul>
</li>
</ul>
@ -492,7 +485,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>For program version 0.3.1</p>
<p>For program version 0.4.0</p>
</div>
</div>
</div>
@ -505,18 +498,13 @@ It is used to start your programs, remember their (JACK) interconnections and ma
in general.</p>
</div>
<div class="paragraph">
<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">
<p>This is a proof of concept version. It aims to show that session management with NSM can be quick
and convenient and make the user feel in control. Some functionality has not yet been
implemented, most prominently anything related to NSM over network. There is always the possibility to
break things when trying out corner cases and hacks.</p>
<p>You can create a session, or project, add programs to it and then use commands to save, start/stop,
hide/show all programs at once, or individually. At a later date you can then re-open
the session and continue where you left off.</p>
</div>
<div class="paragraph">
<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>
<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>
</div>
@ -562,134 +550,52 @@ setup, but everything is saved automatically as long as you manage everything th
<p>Start Agordejo (Start menu, terminal etc.)</p>
</li>
<li>
<p>You are now in the "Quick View" to start a session</p>
</li>
<li>
<p>Press the big button "Start New Session"</p>
<p>Press the button "Quick New" on the left</p>
</li>
<li>
<p>Now you get a choice of programs:</p>
</li>
<li>
<p>A single click with the mouse starts a program</p>
<p>A double single click with the mouse starts a program</p>
</li>
<li>
<p>Another click hides (or subsequently shows) its graphical interface</p>
<p>The program appears as entry in the other column and indicates that it is running</p>
</li>
<li>
<p>If the program crashes you get a warning and can restart it.</p>
<p>To show it&#8217;s GUI you probably need to double click on this new entry.</p>
</li>
<li>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.</p>
<p>The programs "jackpatch" and "nsm-data" were already added automatically.</p>
</li>
<li>
<p>To get more programs and advanced features you can switch to the tab "Full View</p>
<p>Audio and midi ports can now be connected together in a patchbay. The connections are stored in Agordejo.</p>
</li>
<li>
<p>The name of the session so far is simply a date. By clicking on it you can enter a real name. Like "My song"</p>
<p>The name of the session so far is simply a date. Through the menu you can enter a real name. Like "My song"</p>
</li>
<li>
<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 using the menus "Save and Close"</p>
</li>
<li>
<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>
<p>All stored data is in a single directory on the hard disk (<code>~/.local/share/nms/My Song</code>)</p>
</li>
<li>
<p>The session can be resumed: After clicking on the name, all programs start automatically and connect their JACK ports to among themselves.</p>
<p>The session can be resumed: After double clicking on the name, all programs start automatically and connect their JACK ports to among themselves.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>"Quick View" is a good start. However, usually one would like to get into the full view, even if it
is only to start a program twice or to save manually.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_quick_view">3. Quick View</h2>
<h2 id="_full_explanation">3. Full Explanation</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The quick view is an environment reduced to the minimum. You, as a user, should have to make as few
decisions as possible and start an old session or create a new one as quickly as possible (with the
at least clicks).</p>
</div>
<div class="paragraph">
<p>For stability reasons, only programs are shown that are known to
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
back and forth at any time.</p>
</div>
<div class="sect2">
<h3 id="_selecting_a_session">3.1. Selecting a Session</h3>
<div class="paragraph">
<p>There are only two options here: Click on "Start New Session" to do so, or
select one of the existing sessions to resume it (if available).</p>
</div>
</div>
<div class="sect2">
<h3 id="_in_a_session">3.2. In a Session</h3>
<div class="paragraph">
<p>The name can be changed. We recommend a date in the form YYYY-MM-DD followed by a informative name.
Please note that the name change will only take effect (e.g. renaming the session directory on
disk) when you close the session.</p>
</div>
<div class="paragraph">
<p>Next, a larger text field is available for notes. Write what you want. TODO lists, lyrics, credits
and sources of external samples etc.</p>
</div>
<div class="paragraph">
<p>Programs are symbolized by icons. A mouse click starts the program (which can take a while, we have
no influence on that). The status of the program is indicated by a symbol: The "Play" symbol for
the running program, the eye means "program window hidden", the "Power On/Off" symbol means that
the program has been terminated (or crashed).</p>
</div>
<div class="paragraph">
<p>If the program supports it, a running program window can be hidden. Synthesizers, once set up, do
not have to be permanently visible. Just click on the program icon again. Either nothing happens
(the program does not support it) or the window will hide. Another click on a hidden window shows
it again. Every program itself is responsible for whether it saves its window state. Also, some
programs already start hidden.</p>
</div>
<div class="paragraph">
<p>There is <strong>no</strong> way to end or remove a program in this view. To do this, switch to the full view or
use the close function of the program itself.</p>
</div>
<div class="paragraph">
<p>There is also <strong>no</strong> possibility to start a program multiple times, e.g. one synthesizer per
track. If you want to start multiple program instances through the full view times you can still
use the quick view to manage the general session, but it is not defined which program instance a
click on the icon (e.g. to hide) affects. Multiple instances are a clear indicator that you are
ready for the full view.</p>
</div>
<div class="paragraph">
<p>As you&#8217;ll eventually discover, not <strong>all</strong> available programs are in the list, and there there is
also no possibility to start programs that would work well in a session (e.g. a tuner), but are not
explicitly written for it, e.g. do not report their status. It is better to manage these programs
in full view.</p>
</div>
<div class="paragraph">
<p>If, unfortunately, a program has crashed, you can only restart it and hope its automatic saving
worked. Good luck.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_full_view">4. Full View</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Some concepts have already been explained in the chapter "Quick View". It is expected that you have
read this.</p>
</div>
<div class="sect2">
<h3 id="_selecting_a_session_2">4.1. Selecting a Session</h3>
<div class="paragraph">
<p>Sessions are displayed as a table, which you sort by clicking on a column header. Here is shown how
the session is called and when it was saved the last time, probably the two most important pieces
of information. Also shown is how many programs/clients are in the session and whether it contains
@ -719,14 +625,6 @@ rename, move, or delete the session directories themselves (unless they are is c
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 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
deleting the lock file.</p>
</div>
<div class="paragraph">
<p>Click on "New session" to create one. In contrast to the quick view, you must enter the name
directly . As mentioned above, you can use the directory tree. In addition, there are several
(almost obligatory) programs suggested to start with. Normally one should accept all suggestions.
@ -737,9 +635,9 @@ There is always the option to remove them later.</p>
</div>
</div>
<div class="sect2">
<h3 id="_in_a_session_2">4.2. In a Session</h3>
<h3 id="_in_a_session">3.2. In a Session</h3>
<div class="paragraph">
<p>The full view is divided into three areas: Program starter, programs in the current session
<p>The view is divided into three areas: Program starter, programs in the current session
and the session notes. There is also a dynamic menu.</p>
</div>
<div class="paragraph">
@ -748,7 +646,7 @@ session. You can also start a program more than once. For available programs ple
chapter "Program Database".</p>
</div>
<div class="sect3">
<h4 id="_running_programs">4.2.1. Running Programs</h4>
<h4 id="_running_programs">3.2.1. Running Programs</h4>
<div class="paragraph">
<p>Started programs are located on the right side. A double-click switches the visibility
to hide its window if the program supports it. If not, nothing happens.</p>
@ -818,7 +716,7 @@ lyrics, credits and sources from external Samples etc.</p>
</div>
</div>
<div class="sect3">
<h4 id="_the_session_menu">4.2.2. The Session Menu</h4>
<h4 id="_the_session_menu">3.2.2. The Session Menu</h4>
<div class="paragraph">
<p>In contrast to the quick view, full mode offers menus, which can also be accessed via the usual keyboard shortcuts (Ctrl+S for saving etc.).</p>
</div>
@ -849,7 +747,7 @@ lyrics, credits and sources from external Samples etc.</p>
</div>
</div>
<div class="sect1">
<h2 id="_program_database">5. Program-Database</h2>
<h2 id="_program_database">4. Program-Database</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Agordejos launcher is based on a program database, which is partly self-generated, partly
@ -874,7 +772,7 @@ management please report it to <a href="mailto:info@laborejo.org">info@laborejo.
<p>In addition, you can add (in full view) programs that are not in the database.</p>
</div>
<div class="sect2">
<h3 id="_for_advanced_users">5.1. For advanced users</h3>
<h3 id="_for_advanced_users">4.1. For advanced users</h3>
<div class="paragraph">
<p>The strict rule is that only programs in the $PATH are included in the database. Absolutel paths
are not allowed, even if you enter the program name yourself through the menu. However sometimes
@ -895,7 +793,7 @@ search paths. One absolute directory path per line, no wildcards, trailing slash
</div>
</div>
<div class="sect1">
<h2 id="_tray">6. Tray</h2>
<h2 id="_tray">5. Tray</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Agordejo has a tray icon, if your window manager supports it. A click on the trayicon shows or
@ -920,16 +818,7 @@ program and the session is not terminated, but minimized to the tray.</p>
</div>
</div>
<div class="sect1">
<h2 id="_network_sessions">7. Network Sessions</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The functionality to distribute sessions over the local network is planned for a later program
version.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_program_parameters">8. Program parameters</h2>
<h2 id="_program_parameters">6. Program parameters</h2>
<div class="sectionbody">
<div class="paragraph">
<p>As an advanced user, you can start Agordejo in the terminal and add some parameters.. For a
@ -966,7 +855,7 @@ If your system uses a start menu you will find not only the normal Agordejo star
</div>
</div>
<div class="sect1">
<h2 id="_miscellaneous_explanations_faq">9. Miscellaneous / Explanations / FAQ</h2>
<h2 id="_miscellaneous_explanations_faq">7. Miscellaneous / Explanations / FAQ</h2>
<div class="sectionbody">
<div class="paragraph">
<p><strong>Session Save and Exit responds slowly</strong>: Agordejo is not a standalone program like an word
@ -1053,7 +942,7 @@ even complex technical scenarios, e.g. distributing sessions over the network.</
</div>
</div>
<div class="sect1">
<h2 id="_installation_and_start">10. Installation and Start</h2>
<h2 id="_installation_and_start">8. Installation and Start</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Agordejo is exclusive for Linux. The best way to install is to use your package manager.
@ -1112,13 +1001,13 @@ be helpful for testing and development.</p>
</div>
</div>
<div class="sect1">
<h2 id="_help_and_development">11. Help and Development</h2>
<h2 id="_help_and_development">9. Help and Development</h2>
<div class="sectionbody">
<div class="paragraph">
<p>You can help Agordejo in several ways: Testing and reporting errors, translating, marketing, support, programming and more.</p>
</div>
<div class="sect2">
<h3 id="_testing_and_reporting_errors">11.1. Testing and Reporting Errors</h3>
<h3 id="_testing_and_reporting_errors">9.1. Testing and Reporting Errors</h3>
<div class="paragraph">
<p>If you find a bug in the program (or it runs too slow) please contact us in a way that suits you best.
We are thankful for any help.</p>
@ -1142,14 +1031,14 @@ We are thankful for any help.</p>
</div>
</div>
<div class="sect2">
<h3 id="_programming">11.2. Programming</h3>
<h3 id="_programming">9.2. Programming</h3>
<div class="paragraph">
<p>If you want to do some programming and don&#8217;t know where to start please get in contact with us directly.
The short version is: clone the git, change the code, create a git patch or point me to your public git.</p>
</div>
</div>
<div class="sect2">
<h3 id="_translations">11.3. Translations</h3>
<h3 id="_translations">9.3. Translations</h3>
<div class="paragraph">
<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>
@ -1244,7 +1133,7 @@ The easiest way is to contact the developers and they will setup the new languag
</div>
<div id="footer">
<div id="footer-text">
Last updated 2022-04-08 17:30:25 +0200
Last updated 2022-04-15 00:39:29 +0200
</div>
</div>
</body>

191
documentation/out/german.html

@ -450,41 +450,34 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<li><a href="#_anwendungsbeispiel">1.1. Anwendungsbeispiel</a></li>
</ul>
</li>
<li><a href="#_die_schnelle_ansicht">2. Die Schnelle Ansicht</a>
<li><a href="#_vollständige_erklärung">2. Vollständige Erklärung</a>
<ul class="sectlevel2">
<li><a href="#_session_auswählen">2.1. Session Auswählen</a></li>
<li><a href="#_in_einer_session">2.2. In einer Session</a></li>
</ul>
</li>
<li><a href="#_die_volle_ansicht">3. Die Volle Ansicht</a>
<ul class="sectlevel2">
<li><a href="#_session_auswählen_2">3.1. Session Auswählen</a></li>
<li><a href="#_in_einer_session_2">3.2. In einer Session</a>
<li><a href="#_in_einer_session">2.2. In einer Session</a>
<ul class="sectlevel3">
<li><a href="#_laufende_programm">3.2.1. Laufende Programm</a></li>
<li><a href="#_das_session_menü">3.2.2. Das Session Menü</a></li>
<li><a href="#_laufende_programm">2.2.1. Laufende Programm</a></li>
<li><a href="#_das_session_menü">2.2.2. Das Session Menü</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#_programm_datenbank">4. Programm-Datenbank</a>
<li><a href="#_programm_datenbank">3. Programm-Datenbank</a>
<ul class="sectlevel2">
<li><a href="#_für_fortgeschrittene">4.1. Für Fortgeschrittene</a></li>
<li><a href="#_für_fortgeschrittene">3.1. Für Fortgeschrittene</a></li>
</ul>
</li>
<li><a href="#_tray">5. Tray</a></li>
<li><a href="#_netzwerk_sessions">6. Netzwerk-Sessions</a></li>
<li><a href="#_programmparameter">7. Programmparameter</a></li>
<li><a href="#_verschiedenes_erklärungen_faq">8. Verschiedenes / Erklärungen / FAQ</a></li>
<li><a href="#_installation_und_start">9. Installation und Start</a></li>
<li><a href="#_helfen_und_entwicklung">10. Helfen und Entwicklung</a>
<li><a href="#_tray">4. Tray</a></li>
<li><a href="#_programmparameter">5. Programmparameter</a></li>
<li><a href="#_verschiedenes_erklärungen_faq">6. Verschiedenes / Erklärungen / FAQ</a></li>
<li><a href="#_installation_und_start">7. Installation und Start</a></li>
<li><a href="#_helfen_und_entwicklung">8. Helfen und Entwicklung</a>
<ul class="sectlevel2">
<li><a href="#_testen_und_programmfehler">10.1. Testen und Programmfehler</a></li>
<li><a href="#_testen_und_programmfehler">8.1. Testen und Programmfehler</a></li>
</ul>
</li>
<li><a href="#_entwicklung">11. Entwicklung</a>
<li><a href="#_entwicklung">9. Entwicklung</a>
<ul class="sectlevel2">
<li><a href="#_übersetzungen">11.1. Übersetzungen</a></li>
<li><a href="#_übersetzungen">9.1. Übersetzungen</a></li>
</ul>
</li>
</ul>
@ -494,7 +487,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>Für Programmversion 0.3.1</p>
<p>Für Programmversion 0.4.0</p>
</div>
</div>
</div>
@ -544,137 +537,52 @@ Manager Agordejo starten.</p>
<p>Agordejo starten (Startmenü, Terminal etc.)</p>
</li>
<li>
<p>Man befindet sich nun in der "Schnellen Ansicht" um eine Session zu starten</p>
</li>
<li>
<p>Der große Knopf: "Starte Neue Session"</p>
<p>Den Knopf auf der linken Seite drücken: "Schnellstart Neu"</p>
</li>
<li>
<p>Nun bekommt man eine Auswahl an Programmen:</p>
</li>
<li>
<p>Ein einfacher Klick mit der Maus startet ein Programm</p>
<p>Ein Doppelklick mit der Maus startet ein Programm</p>
</li>
<li>
<p>Ein weiterer Klick versteckt (oder zeigt anschließend) dessen grafische Oberfläche</p>
<p>Das Programm erscheint in der anderen Spalte und zeigt an, dass es läuft.</p>
</li>
<li>
<p>Sollte das Programm abstürzen bekommt man das signalisiert und kann es neustarten.</p>
<p>Die GUI des Programms erscheint evtl. erst wenn man auf den neuen Eintrag doppelklickt.</p>
</li>
<li>
<p>Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.</p>
<p>Die Programme "jackpatch" und "nsm-data" wurden schon automatisch hinzugefügt</p>
</li>
<li>
<p>Um andere Programme und erweiterte Funktionen zu bekommen kann man in den Tab "Volle Ansicht" wechseln</p>
<p>Audio- und Midiports können nun in einer Patchbay miteinander verbunden werden. Die Verbindungen werden in Agordejo gespeichert.</p>
</li>
<li>
<p>Der Name der Session ist bisher einfach ein Datum. Durch Klick auf dieses kann man einen richtigen Namen eingeben. Etwa "Mein Lied"</p>
<p>Der Name der Session ist bisher einfach ein Datum. Im Menü kann man richtigen Namen eingeben. Etwa "Mein Lied"</p>
</li>
<li>
<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 Menüeintrag "Speichern und Schließen" wieder in die Sessionauswahl zurück</p>
</li>
<li>
<p>Nun könnte Agordejo geschlossen werden.</p>
</li>
<li>
<p>Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (<code>~/NSM Sessions/Mein Lied</code>)</p>
<p>Alle gespeicherten Daten liegen in einem einzigen Verzeichnis auf der Festplatte (<code>~/.local/share/nms/Mein Lied</code>)</p>
</li>
<li>
<p>Die Session kann weitergeführt werden: Nach dem Klick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.</p>
<p>Die Session kann weitergeführt werden: Nach dem Doppelklick auf den Namen starten alle Programme automatisch und verbinden ihre JACK-Ports untereinander.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Die "Schnelle Ansicht" ist ein guter Einstieg. Üblicherweise möchte man jedoch bald in die volle
Ansicht wechseln, und sei es nur um ein Programm zwei mal zu starten oder um zwischendurch manuell
zu speichern.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_die_schnelle_ansicht">2. Die Schnelle Ansicht</h2>
<h2 id="_vollständige_erklärung">2. Vollständige Erklärung</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Die Schnelle Ansicht ist eine aufs Minimum reduzierte Umgebung. Sie, als Benutzer, sollen so wenig
Entscheidungen wie möglich zu treffen haben und so schnell wie möglich (mit den wenigstens Klicks)
eine alte Session starten oder eine neue erstellen können.</p>
</div>
<div class="paragraph">
<p>Aus Stabilitätsgründen werden nur Programme zum Starten angeboten, von denen bekannt ist, dass Sie
korrekt mit dem Session Management Agordejos zusammenarbeiten.</p>
</div>
<div class="paragraph">
<p>Die Schnelle Ansicht ist lediglich eine Ansicht. Es besteht kein technischer Unterschied zur vollen
Session und Sie können jederzeit hin- und herschalten.</p>
</div>
<div class="sect2">
<h3 id="_session_auswählen">2.1. Session Auswählen</h3>
<div class="paragraph">
<p>Hier gibt es nur zwei Möglichkeiten: Klicken Sie auf "Starte Neue Session" um dies zu tun, oder
wählen Sie eine der bestehenden Sessions aus um diese fortzuführen (sofern vorhanden).</p>
</div>
</div>
<div class="sect2">
<h3 id="_in_einer_session">2.2. In einer Session</h3>
<div class="paragraph">
<p>Der Name kann geändert werden. Wir empfehlen ein Datum in der Form YYYY-MM-DD gefolgt von einem
aussagekräftigen Namen. Bitte beachten Sie, dass die Namensänderung erst wirksam wird (z.B. in Form
des Sessionvereichnisses auf der Platte) wenn Sie die Session schließen.</p>
</div>
<div class="paragraph">
<p>Als nächstes steht ein größeres Textfeld für Notizen zur Verfügung. Schreiben Sie was Sie möchten.
TODO-Listen, Liedtexte, Credits und Quellen von externen Samples etc.</p>
</div>
<div class="paragraph">
<p>Programme werden durch Icons symbolisiert. Ein Mausklick startet das Programm (das kann einen
Moment dauern, darauf haben wir keinen Einfluss). Der Status des Programmes wird durch ein Symbol
dargestellt: Das "Play"-Symbol für das laufende Programm, ein Auge bedeutet "Programmfenster
versteckt", das "Power On/Off"-Symbol bedeutet, dass Programm wurde beendet (oder Absturz).</p>
</div>
<div class="paragraph">
<p>Falls das Programm es unterstützt kann ein laufendes Programmfenster versteckt werden. z.B. ein
Synthesizer, einmal eingerichtet, muss nicht permanent zu sehen sein. Klicken Sie einfach erneut
auf das Programmicon. Entweder passiert nichts (das Programm unterstützt es nicht) oder es wird
versteckt. Ein weiterer Klick auf ein versteckes Fenster zeigt es wieder. Jedes Programm ist selbst
dafür verantwortlich ob es seinen Fensterzustand speichert. Manche Programme starten bereits