audtool - instrukcja obsługi, opcje, przykłady poleceń


NAZWA

audtool - małe narzędzie do sterowania Audacious z linii poleceń.

STRESZCZENIE

audtool [instance] command [parameter ...] ...

OPIS

audtool wysyła polecenia do uruchomionej instancji Audacious.

Może wysyłać wiele typowych poleceń, takich jak przejście do następnego utworu na liście odtwarzania, a także drukować informacje o stanie, takie jak tytuł bieżącego utworu.

instancja może być podana jako -1, -2 itd. (do -9), aby określić, która instancję Audacious, aby kontrolować, kiedy uruchomiono wiele instancji.

POLECENIA

Aktualne informacje o piosence:

--current-song

Wydrukuj sformatowany tytuł bieżącego utworu. W zależności od ustawień Audacious może to obejmować takie informacje, jak wykonawca i nazwa albumu. Aby wydrukować tylko tytuł utworu, użyj --current-song-tuple-data title.

--current-song-filename

Wydrukuj nazwę pliku (pełna ścieżka lub URI) bieżącego utworu.

--current-song-length

Wydrukuj długość bieżącego utworu w formacie M:SS.

--current-song-length-seconds

Wydrukuj długość bieżącego utworu w sekundach.

--current-song-length-frames

Wydrukuj długość bieżącego utworu w milisekundach.

--current-song-output-length

Wydrukuj licznik czasu odtwarzania w formacie M:SS.

--current-song-output-length-seconds

Wydrukuj licznik czasu odtwarzania w sekundach.

--current-song-output-length-frames

Wydrukuj licznik czasu odtwarzania w milisekundach.

--current-song-bitrate

Wydrukuj szybkość transmisji strumieniowej w bitach na sekundę.

--current-song-bitrate-kbps

Wydrukuj szybkość transmisji strumieniowej w kilobitach na sekundę (1 kilobit=1000 bitów).

--current-song-frequency

Wydrukuj częstotliwość próbkowania w hercach.

--current-song-frequency-khz

Wydrukuj częstotliwość próbkowania w kilohercach.

--current-song-channels

Wydrukuj liczbę kanałów audio.

--current-song-tuple-data field

Wydrukuj wartość pola z nazwą (artysta, rok, gatunek itp.) dla bieżącego utworu. W przypadku pominięcia nazwy pola wydrukowana zostanie lista dozwolonych pól.

--current-song-info

Wydrukuj szybkość transmisji strumieniowej, częstotliwość próbkowania i liczbę kanałów audio.

Komendy odtwarzania:

--playback-play

Rozpocznij odtwarzanie. W przypadku wstrzymania odtwarzanie zostanie wznowione od tego samego miejsca. Jeśli jest już aktywny i nie został wstrzymany, rozpocznie się ponownie od początku utworu.

--playback-pause

Wstrzymaj odtwarzanie lub wznów, jeśli zostało już wstrzymane.

--playback-playpause

Odpowiednik --playback-pause, jeśli odtwarzanie jest aktywne, w przeciwnym razie --playback-play.

--playback-stop

Zatrzymaj odtwarzanie.

--playback-playing

Zwróć kod zakończenia 0 (prawda), jeśli odtwarzanie jest aktywne.

--playback-paused

Zwraca kod zakończenia 0 (prawda), jeśli odtwarzanie jest wstrzymane.

--playback-stopped

Zwróć kod zakończenia 0 (prawda), jeśli odtwarzanie nie jest aktywne.

--playback-status

Wydrukuj stan odtwarzania (``odtwarzanie'', ``wstrzymane'' lub ``zatrzymane'').

--playback-seek time

Szukaj podanego czasu w sekundach, w stosunku do początku utworu.

--playback-seek-relative time

Szukaj podanego czasu w sekundach, w stosunku do aktualnego licznika czasu.

--playback-record

Przełącz nagrywanie strumienia wyjściowego (za pomocą FileWriter).

--playback-recording

Zwróć kod zakończenia 0 (prawda), jeśli nagrywanie strumienia jest włączone.

Wybór listy odtwarzania:

--select-displayed

Określa, że wszelkie kolejne polecenia listy odtwarzania powinny dotyczyć listy odtwarzania aktualnie wyświetlanej przez Audacious, niezależnie od tego, która lista odtwarzania jest odtwarzana. To ustawienie obowiązuje, dopóki nie zostanie zastąpione przez --select-playing lub dopóki Audacious nie zostanie ponownie uruchomiony.

Dotyczy to również następujących poleceń:

--current-song
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
--select-playing

Określa, że gdy odtwarzanie jest aktywne, wszelkie kolejne polecenia listy odtwarzania powinny dotyczyć aktualnie odtwarzanej listy odtwarzania. Po zatrzymaniu odtwarzania zachowanie jest takie samo jak --select-displayed. To ustawienie jest domyślne.

Polecenia listy odtwarzania:

--playlist-advance

Przejdź do następnego utworu na liście odtwarzania.

--playlist-reverse

Przejdź do poprzedniego utworu na liście odtwarzania.

--playlist-addurl path

Dodaj piosenkę na koniec listy odtwarzania. Można podać identyfikator URI lub lokalną ścieżkę do pliku (bezwzględną lub względną).

--playlist-insurl path position

Wstaw utwór na podanej pozycji (jeden na podstawie) na liście odtwarzania.

--playlist-addurl-to-new-playlist path

Dodaj utwór do listy odtwarzania „Teraz odtwarzane”, w razie potrzeby utwórz listę odtwarzania i rozpocznij odtwarzanie utworu. W zależności od ustawień Audacious, lista odtwarzania może zostać najpierw wyczyszczona.

--playlist-delete position

Usuń utwór na podanej pozycji z listy odtwarzania.

--playlist-length

Wydrukuj liczbę utworów na liście odtwarzania.

--playlist-song position

Wydrukuj sformatowany tytuł utworu na liście odtwarzania.

--playlist-song-filename position

Wydrukuj nazwę pliku (pełną ścieżkę lub URI) utworu na liście odtwarzania.

--playlist-song-length position

Wydrukuj długość utworu na liście odtwarzania w formacie M:SS.

--playlist-song-length-seconds position

Wydrukuj długość utworu na liście odtwarzania w sekundach.

--playlist-song-length-frames position

Wydrukuj długość utworu na liście odtwarzania w milisekundach.

--playlist-tuple-data field position

Wydrukuj wartość nazwanego pola dla utworu na liście odtwarzania.

--playlist-display

Wydrukuj tytuły wszystkich utworów na liście odtwarzania.

--playlist-position

Wydrukuj pozycję bieżącego utworu na liście odtwarzania.

--playlist-jump position

Przejdź do utworu na danej pozycji na liście odtwarzania.

--playlist-clear

Wyczyść listę odtwarzania.

--playlist-auto-advance-status

Wydrukuj stan automatycznego przesuwania listy odtwarzania (``on'' lub ``off'').

--playlist-auto-advance-toggle

Przełącz automatyczne przesuwanie listy odtwarzania.

--playlist-repeat-status

Wydrukuj stan powtarzania listy odtwarzania (``on'' lub ``off'').

--playlist-repeat-toggle

Przełącz powtarzanie listy odtwarzania.

--playlist-shuffle-status

Wydrukuj status odtwarzania losowego (``on'' lub ``off'').

--playlist-shuffle-toggle

Przełącz odtwarzanie losowe listy odtwarzania.

--playlist-stop-after-status

Wypisuje opcję ``stop po bieżącym utworze'' (``on'' lub ``off'').

--playlist-stop-after-toggle

Przełącz opcję „zatrzymaj po bieżącym utworze”.

Więcej poleceń listy odtwarzania:

--number-of-playlists

Wydrukuj liczbę otwartych list odtwarzania.

--current-playlist

Wydrukuj numer bieżącej listy odtwarzania, gdzie „bieżąca” jest interpretowana zgodnie z --select-displayed lub --select-playing.

--play-current-playlist

Rozpocznij odtwarzanie z bieżącej listy odtwarzania, w miarę możliwości wznawiając odtwarzanie od ostatniego odtwarzanego punktu. Kiedy działa --select-displayed, to polecenie może być użyte do przełączenia odtwarzania na wyświetlaną listę odtwarzania.

--set-current-playlist playlist

Wyświetl podaną listę odtwarzania. Kiedy działa --select-playing i odtwarzana jest inna lista odtwarzania, to polecenie również przełączy odtwarzanie na daną listę odtwarzania. Opcja --select-displayed wyłącza to zachowanie.

--current-playlist-name

Wydrukuj tytuł bieżącej listy odtwarzania.

--set-current-playlist-name title

Ustaw tytuł bieżącej listy odtwarzania.

--new-playlist

Wstaw nową listę odtwarzania po bieżącej i przełącz się na nią tak, jakby użyto --set-current-playlist.

--delete-current-playlist

Usuń bieżącą listę odtwarzania.

Polecenia kolejki listy odtwarzania:

--playqueue-add position

Dodaj utwór na podanej pozycji listy odtwarzania do kolejki.

--playqueue-remove position

Usuń utwór z podanej pozycji listy odtwarzania z kolejki.

--playqueue-is-queued position

Zwróć kod zakończenia 0 (prawda), jeśli utwór na danej pozycji listy odtwarzania znajduje się w kolejce.

--playqueue-get-queue-position position

Wydrukuj pozycję w kolejce utworu na danej pozycji listy odtwarzania.

--playqueue-get-list-position position

Wydrukuj pozycję listy odtwarzania utworu w danej pozycji w kolejce.

--playqueue-length

Wydrukuj liczbę utworów w kolejce.

--playqueue-display

Wydrukuj tytuły wszystkich utworów w kolejce.

--playqueue-clear

Wyczyść kolejkę.

Regulacja głośności i korektor:

--get-volume

Wydrukuj aktualny poziom głośności w procentach.

--set-volume level

Ustaw aktualny poziom głośności w procentach.

--equalizer-activate [on|off]

Włączanie lub wyłączanie korektora.

--equalizer-get

Wydrukuj ustawienia korektora (przedwzmacniacz i wzmocnienie dla wszystkich pasm) w decybelach.

--equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9

Ustaw ustawienia korektora (przedwzmacniacz i wzmocnienie dla wszystkich pasm) w decybelach.

--equalizer-get-preamp

Wydrukuj wstępne wzmocnienie korektora w decybelach.

--equalizer-set-preamp preamp

Ustaw przedwzmacniacz korektora w decybelach.

--equalizer-get-band band

Wydrukuj wzmocnienie danego pasma korektora (0-9) w decybelach.

--equalizer-set-band band gain

Ustaw wzmocnienie danego pasma korektora (0-9) w decybelach.

Różnorodny:

--mainwin-show [on|off]

Pokaż lub ukryj okno Audacious.

--filebrowser-show [on|off]

Pokaż lub ukryj okno Dodaj pliki.

--jumptofile-show [on|off]

Pokaż lub ukryj okno Skok do utworu.

--preferences-show [on|off]

Pokaż lub ukryj okno Ustawienia.

--about-show [on|off]

Pokaż lub ukryj okno Informacje.

--version

Wydrukuj informacje o wersji.

--plugin-is-enabled plugin

Zwróć kod wyjścia 0 (prawda), jeśli dana wtyczka jest włączona. Wtyczka jest określana za pomocą nazwy zainstalowanego pliku minus ścieżka folderu i sufiks: na przykład crossfade dla lib/audacious/Effect/crossfade.so.

--plugin-enable plugin [on|off]

Włącz lub wyłącz daną wtyczkę. Zauważ, że wtyczki interfejsu i wyjścia nie mogą być wyłączone bezpośrednio, ponieważ jedna z nich musi być zawsze aktywna. Włączenie wtyczki interfejsu lub wyjścia spowoduje automatyczne wyłączenie poprzedniej wtyczki.

--config-get [section:]name

Wydrukuj wartość ustawienia konfiguracji. Jakiekolwiek użycie tego polecenia jest całkowicie nieobsługiwane. Znalezienie sekcji i nazwy danego ustawienia pozostawiamy czytelnikowi jako ćwiczenie.

--config-set [section:]name value

Zmień wartość ustawienia konfiguracji. To polecenie jest nieobsługiwane i niebezpieczne. Może mieć nieoczekiwane skutki uboczne (takie jak awaria Audacious) lub może nie mieć żadnego efektu. Używaj go na własne ryzyko!

--shutdown

Zamknij Audaciousa.

--help

Wydrukuj krótkie podsumowanie poleceń narzędzia audtool.

Polecenia mogą być poprzedzone `--' (długie opcje w stylu GNU) lub nie, twój wybór.

BŁĘDY

Obecnie nie ma żadnych znanych błędów w narzędziu audtool; jeśli je znajdziesz, zgłoś je na https://redmine.audacious-media-player.org/projects/audacious.

AUTORSKI

Narzędzie audtool zostało napisane przez George'a Averilla i Ariadne Conill .

Ta strona podręcznika została napisana przez Adama Cecile i Kiyoshi Aman . Kilka dodatkowych poprawek wprowadzili Ariadne Conill i Tony Vroon . Strona podręcznika została zaktualizowana dla Audacious 3.7 i nowszych przez Johna Lindgrena .

Ta praca jest objęta licencją Creative Commons Attribution 3.0 Unported License .

ZOBACZ TEŻ

audacious(1)

STRONA INTERNETOWA

https://audacious-media-player.org