audtool - คู่มืออ้างอิง ตัวเลือก ตัวอย่างคำสั่ง

ชื่อ

audtool - เครื่องมือขนาดเล็กในการควบคุม Audacious จากบรรทัดคำสั่ง

เรื่องย่อ

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

คำอธิบาย

audtool ส่งคำสั่งไปยังอินสแตนซ์ของ Audacious ที่ทำงานอยู่

สามารถส่งคำสั่งทั่วไปมากมาย เช่น เพื่อข้ามไปยังเพลงถัดไปในรายการเล่น และยังสามารถพิมพ์ข้อมูลสถานะ เช่น ชื่อเพลงปัจจุบัน

อินสแตนซ์ อาจกำหนดเป็น -1, -2 เป็นต้น (จนถึง -9) เพื่อระบุว่า อินสแตนซ์ของ Audacious เพื่อควบคุมเมื่อมีการเริ่มต้นหลายอินสแตนซ์

คำสั่ง

ข้อมูลเพลงปัจจุบัน:

--current-song: พิมพ์ชื่อรูปแบบของเพลงปัจจุบัน ขึ้นอยู่กับการตั้งค่า Audacious ซึ่งอาจรวมถึงข้อมูลต่างๆ เช่น ศิลปินและชื่ออัลบั้ม หากต้องการพิมพ์เฉพาะชื่อเพลง ให้ใช้ --current-song-tuple-data title แทน
--current-song-filename: พิมพ์ชื่อไฟล์ (เส้นทางแบบเต็มหรือ URI) ของเพลงปัจจุบัน
--current-song-length: พิมพ์ความยาวของเพลงปัจจุบันในรูปแบบ M:SS
--current-song-length-seconds: พิมพ์ความยาวของเพลงปัจจุบันเป็นวินาที
--current-song-length-frames: พิมพ์ความยาวของเพลงปัจจุบันเป็นมิลลิวินาที
--current-song-output-length: พิมพ์ตัวนับเวลาเล่นในรูปแบบ M:SS
--current-song-output-length-seconds: พิมพ์ตัวนับเวลาเล่นเป็นวินาที
--current-song-output-length-frames: พิมพ์ตัวนับเวลาเล่นเป็นมิลลิวินาที
--current-song-bitrate: พิมพ์บิตเรตการสตรีมเป็นบิตต่อวินาที
--current-song-bitrate-kbps: พิมพ์บิตเรตการสตรีมเป็นกิโลบิตต่อวินาที (1 กิโลบิต=1,000 บิต)
--current-song-frequency: พิมพ์อัตราการสุ่มตัวอย่างเป็นเฮิรตซ์
--current-song-frequency-khz: พิมพ์อัตราการสุ่มตัวอย่างเป็นกิโลเฮิรตซ์
--current-song-channels: พิมพ์จำนวนช่องสัญญาณเสียง
--current-song-tuple-data field: พิมพ์ค่าของฟิลด์ที่มีชื่อ (ศิลปิน ปี ประเภท ฯลฯ) สำหรับเพลงปัจจุบัน หากไม่ระบุชื่อฟิลด์ รายการฟิลด์ที่อนุญาตจะถูกพิมพ์ออกมา
--current-song-info: พิมพ์บิตเรตการสตรีม อัตราการสุ่มตัวอย่าง และจำนวนช่องสัญญาณเสียง

คำสั่งการเล่น:

--playback-play: เริ่มเล่น หากหยุดชั่วคราว การเล่นจะเล่นต่อจากจุดเดิม หากเปิดใช้งานแล้วและไม่หยุดชั่วคราว ระบบจะเริ่มต้นใหม่ตั้งแต่ต้นเพลง
--playback-pause: หยุดเล่นชั่วคราว หรือเล่นต่อหากหยุดชั่วคราวแล้ว
--playback-playpause: เทียบเท่ากับ --playback-pause หากเล่นอยู่ มิฉะนั้น --playback-play
--playback-stop: หยุดเล่น
--playback-playing: ส่งกลับรหัสทางออกเป็น 0 (จริง) หากกำลังเล่นอยู่
--playback-paused: ส่งกลับรหัสทางออกเป็น 0 (จริง) หากหยุดเล่นชั่วคราว
--playback-stopped: ส่งกลับรหัสทางออกเป็น 0 (จริง) หากเล่นไม่ได้
--playback-status: พิมพ์สถานะการเล่น (``กำลังเล่น'', ``หยุดชั่วคราว'' หรือ ``หยุดแล้ว'')
--playback-seek time: ค้นหาเวลาที่กำหนดเป็นวินาที เทียบกับจุดเริ่มต้นของเพลง
--playback-seek-relative time: ค้นหาเวลาที่กำหนดเป็นวินาที โดยสัมพันธ์กับตัวนับเวลาปัจจุบัน
--playback-record: สลับการบันทึกสตรีมเอาต์พุต (โดยใช้ FileWriter)
--playback-recording: ส่งคืนรหัสทางออกเป็น 0 (จริง) หากเปิดใช้งานการบันทึกสตรีม

การเลือกเพลย์ลิสต์:

--select-displayed: ระบุว่าคำสั่งเพลย์ลิสต์ที่ตามมาควรใช้กับเพลย์ลิสต์ที่แสดงโดย Audacious ในปัจจุบัน โดยไม่คำนึงว่าเพลย์ลิสต์ใดกำลังเล่นอยู่ การตั้งค่านี้จะมีผลจนกว่าจะถูกแทนที่โดย --select-playing หรือเริ่ม Audacious ใหม่

คำสั่งต่อไปนี้ได้รับผลกระทบด้วย:

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

--select-playing: ระบุว่าเมื่อเปิดใช้งานการเล่น คำสั่งเพลย์ลิสต์ที่ตามมาควรใช้กับเพลย์ลิสต์ที่กำลังเล่นอยู่ เมื่อหยุดเล่น ลักษณะการทำงานจะเหมือนกับ --select-displayed การตั้งค่านี้เป็นค่าเริ่มต้น

คำสั่งเพลย์ลิสต์:

--playlist-advance: ข้ามไปยังเพลงถัดไปในรายการเพลง
--playlist-reverse: ข้ามไปยังเพลงก่อนหน้าในรายการเพลง
--playlist-addurl path: เพิ่มเพลงในตอนท้ายของเพลย์ลิสต์ อาจกำหนด URI หรือเส้นทางไฟล์ในเครื่อง (แบบสัมบูรณ์หรือแบบสัมพัทธ์)
--playlist-insurl path position: ใส่เพลงในตำแหน่งที่กำหนด (แบบหนึ่ง) ในรายการเพลง
--playlist-addurl-to-new-playlist path: เพิ่มเพลงไปยังเพลย์ลิสต์ ``กำลังเล่นอยู่'' สร้างเพลย์ลิสต์หากจำเป็น และเริ่มเล่นเพลง เพลย์ลิสต์อาจถูกล้างก่อน ทั้งนี้ขึ้นอยู่กับการตั้งค่า Audacious
--playlist-delete position: ลบเพลงในตำแหน่งที่กำหนดออกจากเพลย์ลิสต์
--playlist-length: พิมพ์จำนวนเพลงในรายการเล่น
--playlist-song position: พิมพ์ชื่อรูปแบบของเพลงในเพลย์ลิสต์
--playlist-song-filename position: พิมพ์ชื่อไฟล์ (พาธแบบเต็มหรือ URI) ของเพลงในเพลย์ลิสต์
--playlist-song-length position: พิมพ์ความยาวของเพลงในเพลย์ลิสต์ในรูปแบบ M:SS
--playlist-song-length-seconds position: พิมพ์ความยาวของเพลงในเพลย์ลิสต์เป็นวินาที
--playlist-song-length-frames position: พิมพ์ความยาวของเพลงในเพลย์ลิสต์เป็นมิลลิวินาที
--playlist-tuple-data field position: พิมพ์ค่าของฟิลด์ที่มีชื่อสำหรับเพลงในเพลย์ลิสต์
--playlist-display: พิมพ์ชื่อเพลงทั้งหมดในเพลย์ลิสต์
--playlist-position: พิมพ์ตำแหน่งของเพลงปัจจุบันในรายการเล่น
--playlist-jump position: ข้ามไปยังเพลงในตำแหน่งที่กำหนดในรายการเพลง
--playlist-clear: ล้างเพลย์ลิสต์
--playlist-auto-advance-status: พิมพ์สถานะการเลื่อนอัตโนมัติของเพลย์ลิสต์ (``เปิด'' หรือ ``ปิด'')
--playlist-auto-advance-toggle: สลับการเลื่อนไปข้างหน้าอัตโนมัติของเพลย์ลิสต์
--playlist-repeat-status: พิมพ์สถานะการเล่นซ้ำของเพลย์ลิสต์ (``เปิด'' หรือ ``ปิด'')
--playlist-repeat-toggle: สลับการเล่นซ้ำของเพลย์ลิสต์
--playlist-shuffle-status: พิมพ์สถานะของการสุ่มเพลย์ลิสต์ (``เปิด'' หรือ ``ปิด'')
--playlist-shuffle-toggle: สลับเพลย์ลิสต์แบบสุ่ม
--playlist-stop-after-status: พิมพ์ตัวเลือก ``หยุดหลังจากเพลงปัจจุบัน'' (``เปิด'' หรือ ``ปิด'')
--playlist-stop-after-toggle: สลับตัวเลือก ``หยุดหลังจากเพลงปัจจุบัน''

คำสั่งเพลย์ลิสต์เพิ่มเติม:

--number-of-playlists: พิมพ์จำนวนเพลย์ลิสต์ที่เปิดอยู่
--current-playlist: พิมพ์หมายเลขของเพลย์ลิสต์ปัจจุบัน โดยที่ "ปัจจุบัน" ถูกตีความตาม --เลือกแสดง หรือ --เลือกเล่น
--play-current-playlist: เริ่มเล่นในรายการเพลงปัจจุบัน เล่นต่อจากจุดสุดท้ายที่เล่นถ้าเป็นไปได้ เมื่อ --select-displayed มีผล คำสั่งนี้สามารถใช้เพื่อสลับการเล่นไปยังเพลย์ลิสต์ที่แสดง
--set-current-playlist playlist: แสดงเพลย์ลิสต์ที่กำหนด เมื่อ --เลือกเล่น มีผลและกำลังเล่นเพลย์ลิสต์อื่น คำสั่งนี้จะเปลี่ยนการเล่นเป็นเพลย์ลิสต์ที่กำหนดด้วย ตัวเลือก --select-displayed จะปิดการทำงานนี้
--current-playlist-name: พิมพ์ชื่อรายการเล่นปัจจุบัน
--set-current-playlist-name title: ตั้งชื่อรายการเล่นปัจจุบัน
--new-playlist: แทรกเพลย์ลิสต์ใหม่ต่อจากเพลย์ลิสต์ปัจจุบันและสลับไปยังเพลย์ลิสต์เสมือนว่ามีการใช้ --set-current-playlist
--delete-current-playlist: ลบเพลย์ลิสต์ปัจจุบัน

คำสั่งคิวเพลย์ลิสต์:

--playqueue-add position: เพิ่มเพลงในตำแหน่งเพลย์ลิสต์ที่กำหนดลงในคิว
--playqueue-remove position: ลบเพลงในตำแหน่งเพลย์ลิสต์ที่กำหนดออกจากคิว
--playqueue-is-queued position: ส่งกลับรหัสทางออกเป็น 0 (จริง) หากเพลงในตำแหน่งเพลย์ลิสต์ที่ระบุอยู่ในคิว
--playqueue-get-queue-position position: พิมพ์ตำแหน่งคิวของเพลงในตำแหน่งเพลย์ลิสต์ที่กำหนด
--playqueue-get-list-position position: พิมพ์ตำแหน่งเพลย์ลิสต์ของเพลงในตำแหน่งคิวที่กำหนด
--playqueue-length: พิมพ์จำนวนเพลงในคิว
--playqueue-display: พิมพ์ชื่อเพลงทั้งหมดในคิว
--playqueue-clear: เคลียร์คิว.

การควบคุมระดับเสียงและอีควอไลเซอร์:

--get-volume: พิมพ์ระดับเสียงปัจจุบันเป็นเปอร์เซ็นต์
--set-volume level: ตั้งค่าระดับเสียงปัจจุบันเป็นเปอร์เซ็นต์
--equalizer-activate [on|off]: เปิดหรือปิดใช้งานอีควอไลเซอร์
--equalizer-get: พิมพ์การตั้งค่าอีควอไลเซอร์ (ปรีแอมป์และเกนสำหรับทุกย่านความถี่) เป็นเดซิเบล
--equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9: ตั้งค่าอีควอไลเซอร์ (ปรีแอมป์และเกนสำหรับทุกแบนด์) เป็นเดซิเบล
--equalizer-get-preamp: พิมพ์อีควอไลเซอร์ก่อนการขยายเป็นเดซิเบล
--equalizer-set-preamp preamp: ตั้งค่าการขยายล่วงหน้าของอีควอไลเซอร์เป็นเดซิเบล
--equalizer-get-band band: พิมพ์อัตราขยายของแถบอีควอไลเซอร์ที่กำหนด (0-9) เป็นเดซิเบล
--equalizer-set-band band gain: ตั้งค่าอัตราขยายของแถบอีควอไลเซอร์ที่กำหนด (0-9) เป็นเดซิเบล

เบ็ดเตล็ด:

--mainwin-show [on|off]: แสดงหรือซ่อนหน้าต่าง Audacious
--filebrowser-show [on|off]: แสดงหรือซ่อนหน้าต่างเพิ่มไฟล์
--jumptofile-show [on|off]: แสดงหรือซ่อนหน้าต่างข้ามไปที่เพลง
--preferences-show [on|off]: แสดงหรือซ่อนหน้าต่างการตั้งค่า
--about-show [on|off]: แสดงหรือซ่อนหน้าต่างเกี่ยวกับ
--version: ข้อมูลรุ่นพิมพ์
--plugin-is-enabled plugin: ส่งคืนรหัสทางออกเป็น 0 (จริง) หากเปิดใช้งานปลั๊กอินที่กำหนด มีการระบุปลั๊กอินโดยใช้ชื่อไฟล์ที่ติดตั้งลบด้วยพาธโฟลเดอร์และคำต่อท้าย: ตัวอย่างเช่น crossfade สำหรับ lib/audacious/Effect/crossfade.so
--plugin-enable plugin [on|off]: เปิดหรือปิดใช้งานปลั๊กอินที่กำหนด โปรดทราบว่าไม่สามารถปิดใช้งานอินเทอร์เฟซและปลั๊กอินเอาต์พุตได้โดยตรง เนื่องจากต้องเปิดใช้งานอย่างใดอย่างหนึ่งเสมอ การเปิดใช้งานอินเทอร์เฟซหรือเอาต์พุตปลั๊กอินจะปิดใช้งานปลั๊กอินก่อนหน้าโดยอัตโนมัติ
--config-get [section:]name: พิมพ์ค่าของการตั้งค่าคอนฟิกูเรชัน ไม่รองรับการใช้คำสั่งนี้โดยสิ้นเชิง วิธีค้นหาส่วนและชื่อของการตั้งค่าที่กำหนดนั้นถือเป็นแบบฝึกหัดสำหรับผู้อ่าน
--config-set [section:]name value: เปลี่ยนค่าของการตั้งค่าการกำหนดค่า คำสั่งนี้ไม่ได้รับการสนับสนุนและเป็นอันตราย อาจมีผลข้างเคียงที่ไม่คาดคิด (เช่น Audacious ขัดข้อง) หรืออาจไม่มีผลเลย ใช้โดยยอมรับความเสี่ยงของคุณเอง!
--shutdown: ปิด Audacious
--help: พิมพ์สรุปสั้นๆ ของคำสั่ง auditool

คำสั่งอาจขึ้นต้นด้วย `--' (ตัวเลือกแบบยาวของ GNU) หรือไม่ก็ตาม คุณเลือกได้

ข้อบกพร่อง

ไม่มีข้อผิดพลาดที่รู้จักในเครื่องมือตรวจสอบในขณะนี้ หากคุณพบสิ่งใด โปรดรายงานพวกเขาที่ https://redmine.audacious-media-player.org/projects/audacious

ผู้เขียน

audtool เขียนโดย George Averill nhjm@nhjm.net และ Ariadne Conill ariadne@dereferenced.org

หน้าคู่มือนี้เขียนโดย Adam Cecile gandalf@le-vert.net และ Kiyoshi Aman kiyoshi@atheme.org การปรับแต่งเพิ่มเติมบางอย่างดำเนินการโดย Ariadne Conill ariadne@dereferenced.org และ Tony Vroon chainsaw@gentoo.org หน้าคู่มือได้รับการอัปเดตสำหรับ Audacious 3.7 และใหม่กว่าโดย John Lindgren john@jlindgren.net

งานนี้ได้รับอนุญาตภายใต้ Creative Commons Attribution 3.0 Unported License https://creativecommons.org/licenses/by/3.0/

ดูสิ่งนี้ด้วย

audacious(1)

เว็บไซต์

https://audacious-media-player.org