audtool - hướng dẫn tham khảo, tùy chọn, ví dụ về lệnh


TÊN

audtool - một công cụ nhỏ để kiểm soát Audacious từ dòng lệnh.

TÓM TẮT

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

SỰ MIÊU TẢ

audtool gửi các lệnh đến một phiên bản đang chạy của Audacious.

Nó có thể gửi nhiều lệnh phổ biến, chẳng hạn như chuyển sang bài hát tiếp theo trong danh sách phát và cũng có thể in thông tin trạng thái, chẳng hạn như tiêu đề của bài hát hiện tại.

phiên bản có thể được cung cấp dưới dạng -1, -2, v.v. (tối đa -9) để chỉ định phiên bản Audacious nào sẽ kiểm soát khi nhiều phiên bản đã được bắt đầu.

LỆNH

Thông tin bài hát hiện tại:

--current-song

In tiêu đề được định dạng của bài hát hiện tại. Tùy thuộc vào cài đặt Audacious, điều này có thể bao gồm thông tin như nghệ sĩ và tên album. Để chỉ in tiêu đề bài hát, hãy sử dụng --current-song-tuple-data title thay thế.

--current-song-filename

In tên tệp (đường dẫn đầy đủ hoặc URI) của bài hát hiện tại.

--current-song-length

In thời lượng của bài hát hiện tại ở định dạng M:SS.

--current-song-length-seconds

In thời lượng của bài hát hiện tại tính bằng giây.

--current-song-length-frames

In thời lượng của bài hát hiện tại tính bằng mili giây.

--current-song-output-length

In bộ đếm thời gian phát lại ở định dạng M:SS.

--current-song-output-length-seconds

In bộ đếm thời gian phát lại tính bằng giây.

--current-song-output-length-frames

In bộ đếm thời gian phát lại tính bằng mili giây.

--current-song-bitrate

In tốc độ bit phát trực tuyến tính bằng bit trên giây.

--current-song-bitrate-kbps

In tốc độ bit phát trực tuyến tính bằng kilobit trên giây (1 kilobit=1000 bit).

--current-song-frequency

In tốc độ lấy mẫu tính bằng hertz.

--current-song-frequency-khz

In tốc độ lấy mẫu tính bằng kilohertz.

--current-song-channels

In số kênh âm thanh.

--current-song-tuple-data field

In giá trị của trường được đặt tên (nghệ sĩ, năm, thể loại, v.v.) cho bài hát hiện tại. Nếu tên trường bị bỏ qua, một danh sách các trường được phép sẽ được in.

--current-song-info

In tốc độ bit phát trực tuyến, tốc độ lấy mẫu và số lượng kênh âm thanh.

Các lệnh phát lại:

--playback-play

Bắt đầu phát lại. Nếu bị tạm dừng, quá trình phát lại sẽ tiếp tục từ cùng một điểm. Nếu đã hoạt động và không bị tạm dừng, nó sẽ bắt đầu lại từ đầu bài hát.

--playback-pause

Tạm dừng phát lại hoặc tiếp tục nếu đã tạm dừng.

--playback-playpause

Tương đương với --tạm dừng phát lại nếu phát lại đang hoạt động, nếu không thì --phát lại-phát.

--playback-stop

Dừng phát lại.

--playback-playing

Trả lại mã thoát là 0 (đúng) nếu phát lại đang hoạt động.

--playback-paused

Trả lại mã thoát là 0 (đúng) nếu quá trình phát lại bị tạm dừng.

--playback-stopped

Trả lại mã thoát 0 (đúng) nếu phát lại không hoạt động.

--playback-status

In trạng thái phát lại (``đang phát'', ``tạm dừng'', hoặc ``đã dừng'').

--playback-seek time

Tìm kiếm thời gian nhất định tính bằng giây, so với phần đầu của bài hát.

--playback-seek-relative time

Tìm kiếm thời gian nhất định tính bằng giây, so với bộ đếm thời gian hiện tại.

--playback-record

Chuyển đổi ghi luồng đầu ra (sử dụng FileWriter).

--playback-recording

Trả về mã thoát là 0 (đúng) nếu tính năng ghi luồng được bật.

Lựa chọn danh sách phát:

--select-displayed

Chỉ định rằng mọi lệnh danh sách phát tiếp theo sẽ áp dụng cho danh sách phát hiện được hiển thị bởi Audacious, bất kể danh sách phát nào đang phát. Cài đặt này có hiệu lực cho đến khi nó bị ghi đè bởi --select- Playing hoặc Audacious được khởi động lại.

Các lệnh sau cũng bị ảnh hưởng:

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

Chỉ định rằng khi phát lại đang hoạt động, mọi lệnh danh sách phát tiếp theo sẽ áp dụng cho danh sách phát hiện đang phát. Khi dừng phát lại, hành vi giống như --chọn-hiển thị. Thiết lập này là mặc định.

Lệnh danh sách phát:

--playlist-advance

Chuyển đến bài hát tiếp theo trong danh sách phát.

--playlist-reverse

Bỏ qua bài hát trước đó trong danh sách phát.

--playlist-addurl path

Thêm một bài hát vào cuối danh sách phát. Có thể cung cấp URI hoặc đường dẫn tệp cục bộ (tuyệt đối hoặc tương đối).

--playlist-insurl path position

Chèn một bài hát vào vị trí nhất định (dựa trên một bài hát) trong danh sách phát.

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

Thêm bài hát vào danh sách phát ``Đang phát'', tạo danh sách phát nếu cần và bắt đầu phát bài hát. Tùy thuộc vào cài đặt Audacious, danh sách phát có thể bị xóa trước tiên.

--playlist-delete position

Xóa bài hát ở vị trí nhất định khỏi danh sách phát.

--playlist-length

In số lượng bài hát trong danh sách phát.

--playlist-song position

In tiêu đề đã định dạng của một bài hát trong danh sách phát.

--playlist-song-filename position

In tên tệp (đường dẫn đầy đủ hoặc URI) của bài hát trong danh sách phát.

--playlist-song-length position

In thời lượng của một bài hát trong danh sách nhạc ở định dạng M:SS.

--playlist-song-length-seconds position

In thời lượng của một bài hát trong danh sách nhạc tính bằng giây.

--playlist-song-length-frames position

In thời lượng của một bài hát trong danh sách phát tính bằng mili giây.

--playlist-tuple-data field position

In giá trị của trường được đặt tên cho một bài hát trong danh sách phát.

--playlist-display

In tiêu đề của tất cả các bài hát trong danh sách phát.

--playlist-position

In vị trí của bài hát hiện tại trong danh sách phát.

--playlist-jump position

Chuyển đến bài hát ở vị trí nhất định trong danh sách phát.

--playlist-clear

Xóa danh sách phát.

--playlist-auto-advance-status

In trạng thái tự động nâng cấp danh sách phát (``bật'' hoặc ``tắt'').

--playlist-auto-advance-toggle

Chuyển đổi tự động nâng cấp danh sách phát.

--playlist-repeat-status

In trạng thái lặp lại danh sách phát (``bật'' hoặc ``tắt'').

--playlist-repeat-toggle

Chuyển đổi lặp lại danh sách phát.

--playlist-shuffle-status

In trạng thái phát ngẫu nhiên danh sách phát (``bật'' hoặc ``tắt'').

--playlist-shuffle-toggle

Chuyển đổi danh sách phát ngẫu nhiên.

--playlist-stop-after-status

In tùy chọn ``dừng sau bài hát hiện tại'' (``bật'' hoặc ``tắt'').

--playlist-stop-after-toggle

Chuyển đổi tùy chọn ``dừng sau bài hát hiện tại''.

Các lệnh danh sách phát khác:

--number-of-playlists

In số danh sách phát đang mở.

--current-playlist

In số của danh sách phát hiện tại, trong đó "hiện tại" được diễn giải theo --chọn-hiển thị hoặc --chọn-phát.

--play-current-playlist

Bắt đầu phát lại trong danh sách phát hiện tại, tiếp tục từ điểm cuối cùng đã phát nếu có thể. Khi --select-displayed có hiệu lực, lệnh này có thể được sử dụng để chuyển phát lại sang danh sách phát được hiển thị.

--set-current-playlist playlist

Hiển thị danh sách phát đã cho. Khi --select- Playing có hiệu lực và một danh sách phát khác đang phát, lệnh này cũng sẽ chuyển phát lại sang danh sách phát đã cho. Tùy chọn --select-displayed vô hiệu hóa hành vi này.

--current-playlist-name

In tiêu đề của danh sách phát hiện tại.

--set-current-playlist-name title

Đặt tiêu đề của danh sách phát hiện tại.

--new-playlist

Chèn danh sách phát mới sau danh sách phát hiện tại và chuyển sang danh sách phát đó như thể --set-current-playlist đã được sử dụng.

--delete-current-playlist

Xóa danh sách phát hiện tại.

Lệnh xếp hàng danh sách phát:

--playqueue-add position

Thêm bài hát ở vị trí danh sách phát nhất định vào hàng đợi.

--playqueue-remove position

Xóa bài hát ở vị trí danh sách phát đã cho khỏi hàng đợi.

--playqueue-is-queued position

Trả về mã thoát là 0 (đúng) nếu bài hát ở vị trí danh sách phát đã cho nằm trong hàng đợi.

--playqueue-get-queue-position position

In vị trí hàng đợi của bài hát tại vị trí danh sách phát đã cho.

--playqueue-get-list-position position

In vị trí danh sách phát của bài hát tại vị trí hàng đợi đã cho.

--playqueue-length

In số lượng bài hát trong hàng đợi.

--playqueue-display

In tiêu đề của tất cả các bài hát trong hàng đợi.

--playqueue-clear

Xóa hàng đợi.

Điều khiển âm lượng và cân bằng:

--get-volume

In mức âm lượng hiện tại theo phần trăm.

--set-volume level

Đặt mức âm lượng hiện tại theo phần trăm.

--equalizer-activate [on|off]

Bật hoặc tắt bộ chỉnh âm.

--equalizer-get

In cài đặt bộ chỉnh âm (khuếch đại trước và khuếch đại cho tất cả các băng tần) tính bằng decibel.

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

Đặt cài đặt bộ chỉnh âm (tiền khuếch đại và khuếch đại cho tất cả các dải) tính bằng decibel.

--equalizer-get-preamp

In tiền khuếch đại của bộ cân bằng tính bằng decibel.

--equalizer-set-preamp preamp

Đặt tiền khuếch đại của bộ cân bằng tính bằng decibel.

--equalizer-get-band band

In mức tăng của dải cân bằng đã cho (0-9) tính bằng decibel.

--equalizer-set-band band gain

Đặt mức tăng của dải cân bằng đã cho (0-9) tính bằng decibel.

Điều khoản khác:

--mainwin-show [on|off]

Hiển thị hoặc ẩn cửa sổ Audacious.

--filebrowser-show [on|off]

Hiển thị hoặc ẩn cửa sổ Thêm tệp.

--jumptofile-show [on|off]

Hiển thị hoặc ẩn cửa sổ Chuyển đến Bài hát.

--preferences-show [on|off]

Hiển thị hoặc ẩn cửa sổ Cài đặt.

--about-show [on|off]

Hiển thị hoặc ẩn cửa sổ Giới thiệu.

--version

Thông tin phiên bản in.

--plugin-is-enabled plugin

Trả lại mã thoát là 0 (đúng) nếu plugin đã cho được bật. Plugin được chỉ định bằng cách sử dụng tên tệp đã cài đặt của nó trừ đi đường dẫn thư mục và hậu tố: ví dụ: crossfade cho lib/audacious/Effect/crossfade.so.

--plugin-enable plugin [on|off]

Bật hoặc tắt plugin đã cho. Lưu ý rằng không thể tắt trực tiếp các plugin giao diện và đầu ra vì một trong mỗi plugin phải luôn hoạt động. Kích hoạt giao diện hoặc plugin đầu ra sẽ tự động tắt plugin trước đó.

--config-get [section:]name

In giá trị của cài đặt cấu hình. Bất kỳ việc sử dụng lệnh này là hoàn toàn không được hỗ trợ. Cách tìm phần và tên của một cài đặt nhất định được dành cho người đọc dưới dạng bài tập.

--config-set [section:]name value

Thay đổi giá trị của cài đặt cấu hình. Lệnh này không được hỗ trợ và nguy hiểm. Nó có thể có các tác dụng phụ không mong muốn (chẳng hạn như Audacious gặp sự cố) hoặc có thể không có tác dụng gì cả. Sử dụng nó có nguy cơ của riêng bạn!

--shutdown

Tắt táo bạo.

--help

In một bản tóm tắt ngắn gọn về các lệnh audtool.

Các lệnh có thể được bắt đầu bằng `--' (tùy chọn dài kiểu GNU) hoặc không, tùy bạn chọn.

LỖI

Không có lỗi nào đã biết trong audtool vào thời điểm này; nếu bạn tìm thấy bất kỳ thứ gì, vui lòng báo cáo chúng tại https://redmine.audacious-media-player.org/projects/audacious.

TÁC GIẢ

audtool được viết bởi George Averill và Ariadne Conill .

Trang hướng dẫn này được viết bởi Adam Cecile và Kiyoshi Aman . Ariadne Conill và Tony Vroon đã thực hiện một số chỉnh sửa bổ sung. Trang hướng dẫn đã được cập nhật cho Audacious 3.7 trở lên bởi John Lindgren .

Tác phẩm này được cấp phép theo Giấy phép chưa chuyển đổi Creative Commons Attribution 3.0 .

XEM THÊM

audacious(1)

TRANG MẠNG

https://audacious-media-player.org