Jellyfin
Disertakan dengan Macro DeckKendalikan aplikasi dan TV Jellyfin dari deck Anda, tampilkan apa yang diputar, dan bereaksi saat pemutaran dimulai atau berhenti.
Dua widget Pemutar musik yang memutar lagu, satu dengan gaya Sampul penuh dan satu dengan gaya Sampul kecil, keduanya dengan nama dan logo Jellyfin di bagian atas
- Kendalikan pemutaran dan volume di aplikasi, browser, dan TV Jellyfin
- Cari film, episode, lagu, atau album dan mulai memutarnya
- Pemicu saat pemutaran dimulai, dijeda, dilanjutkan, atau dihentikan
- Widget Pemutar musik dan Sesi Jellyfin
- Hubungkan beberapa server, masing-masing dengan variabelnya sendiri
Integrasi Jellyfin menghubungkan Macro Deck ke satu atau beberapa server media Jellyfin dan bekerja dengan sesi di server tersebut: aplikasi, browser, dan TV Jellyfin yang sudah masuk dan sedang memutar. Integrasi ini tidak membutuhkan plugin Jellyfin. Anda masuk dengan kunci API, yang memungkinkan Macro Deck melihat dan mengendalikan setiap sesi di server, atau dengan nama pengguna dan kata sandi, yang membatasinya pada sesi yang boleh dikendalikan akun tersebut.
Yang dapat dilakukan
- Putar, jeda, hentikan, lewati, lompat ke posisi tertentu, atau maju dan mundur sejumlah detik.
- Atur volume, bisukan dan batalkan bisu, serta atur acak dan ulangi di klien.
- Cari film, episode, lagu, atau album di server dan mulai memutarnya di perangkat dengan Putar media.
- Tampilkan pesan dengan judul di klien Jellyfin.
- Tampilkan apa yang diputar di widget Pemutar musik, atau pemutaran di server Anda di widget Sesi Jellyfin.
- Mulai otomasi saat pemutaran dimulai, dijeda, dilanjutkan, atau dihentikan, saat item berganti, atau saat klien terhubung.
Beberapa contoh penggunaan:
- Tombol Toggle Play/Pause untuk TV ruang keluarga, dengan Cari mundur di sebelahnya untuk mengulang 10 detik terakhir.
- Otomasi pada Pemutaran dimulai untuk TV yang meredupkan lampu saat
{{ event.itemType }}bernilaiMovie, dan otomasi kedua pada Pemutaran dihentikan yang menerangkannya lagi. - Tombol yang menampilkan "Makan malam sudah siap" di TV dengan Tampilkan pesan.
Server dan perangkat
Setiap server yang ditambahkan muncul dalam dua bentuk di mana pun Anda memilih pemutar. Nama server mengikuti sesi mana pun yang terakhir memutar sesuatu. Server · Perangkat, misalnya Home · Living Room TV, selalu menargetkan perangkat tersebut dan ditampilkan sebagai tidak terhubung selama perangkat mati. Macro Deck mengingat perangkat selama 30 hari sejak terakhir melihatnya.
Macro Deck mengikuti server secara langsung melalui WebSocket-nya di Jellyfin 10.11 dan yang lebih baru. Jika server tidak mengirim pembaruan langsung, Macro Deck menanyakan sesi setiap dua detik. Jika server hilang, Macro Deck terus mencoba di latar belakang dan melaporkannya di halaman Jellyfin pada Integrasi setelah beberapa percobaan gagal. Tidak semua klien Jellyfin mendukung setiap perintah: perintah yang tidak dapat dijalankan klien gagal dengan pesan.
Yang Anda butuhkan
- Server Jellyfin yang dapat dijangkau melalui jaringan oleh komputer yang menjalankan Macro Deck.
- Kunci API dari dasbor Jellyfin (disarankan), atau nama pengguna dan kata sandi Jellyfin.
- Jellyfin 10.11 atau yang lebih baru untuk pembaruan langsung. Tanpa itu, Macro Deck menanyakan sesi setiap dua detik.
Cara menyiapkan
Langkah 1: Buat kunci API di Jellyfin
Buka dasbor Jellyfin dan masuk ke API Keys. Buat kunci baru dan salin. Jika Anda lebih suka masuk dengan akun pengguna, lewati langkah ini.
Langkah 2: Tambahkan konfigurasi di Macro Deck
Di Macro Deck, klik Integrasi di bilah samping, lalu klik Jellyfin. Di tab Ringkasan, klik Tambah konfigurasi di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama, dan integrasi menjadi aktif setelah penyiapan selesai.
Langkah 3: Masukkan detail server
Di dialog Hubungkan ke Jellyfin, isi:
- Nama konfigurasi: nama untuk server ini, misalnya
Home. Nama ini digunakan di nama pemutar dan variabel. - Alamat server: alamat beserta port dan base path jika ada, misalnya
http://192.168.1.10:8096. - Masuk dengan: Kunci API atau Nama pengguna dan kata sandi, lalu masukkan Kunci API, atau Nama pengguna dan Kata sandi.
Klik Lanjutkan. Macro Deck memeriksa koneksi sebelum menyimpan.
- Nama konfigurasi: nama untuk server ini, misalnya
Langkah 4: Periksa koneksi
Konfigurasi baru menampilkan Terhubung di bagian Konfigurasi pada halaman Jellyfin. Ulangi langkah-langkah ini untuk setiap server berikutnya.
Langkah 5: Tambahkan aksi ke tombol
Di halaman Deck, klik tombol yang ingin digunakan. Deck harus dalam keadaan tidak terkunci: jika tombol di kanan atas bertuliskan Kunci, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih Jellyfin di sisi kiri dialog Tambah aksi, lalu pilih aksi seperti Toggle Play/Pause. Pilih server atau perangkat yang dikendalikannya, lalu klik Simpan.
Langkah 6: Tekan tombolnya
Mulai memutar sesuatu di klien Jellyfin dan tekan tombol di deck Anda. Pemutaran dijeda atau dilanjutkan di klien tersebut.
Aksi20
Pasang aksi ini di tombol atau jalankan dari alur.
- Play
- Melanjutkan pemutaran di klien.
- Pause
- Menjeda pemutaran di klien.
- Toggle Play/Pause
- Beralih antara putar dan jeda, dan menampilkan status pemutaran di tombol.
- Hentikan
- Menghentikan pemutaran di klien.
- Next Track
- Melompat ke item berikutnya.
- Previous Track
- Melompat ke item sebelumnya.
- Refresh State
- Langsung membaca status pemutaran saat ini.
- Seek
- Melompat ke posisi tertentu di item saat ini, dalam detik.
- Cari maju
- Melompat maju di item saat ini, bawaannya 30 detik.
- Cari mundur
- Melompat mundur di item saat ini, bawaannya 10 detik.
- Set Volume
- Mengatur volume klien, dari 0 hingga 100%.
- Volume Up
- Menaikkan volume sebesar 10%.
- Volume Down
- Menurunkan volume sebesar 10%.
- Bisukan
- Membisukan klien.
- Batalkan bisu
- Menyalakan kembali suara klien.
- Alihkan bisu
- Membisukan klien atau membatalkan bisunya.
- Toggle Shuffle
- Mengaktifkan, menonaktifkan, atau mengalihkan mode acak.
- Set Repeat Mode
- Mengatur ulangi ke Off, Repeat Track, atau Repeat Album/Playlist.
- Tampilkan pesan
- Menampilkan pesan dengan judul di klien selama sejumlah detik.
- Putar media
- Mencari film, episode, lagu, atau album dan memutarnya di klien, menggantikan apa yang sedang diputar di sana.
Pemicu9
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Pemutaran dimulai
- Sebuah sesi mulai memutar sesuatu.
- Pemutaran dijeda
- Pemutaran dijeda di sebuah sesi.
- Pemutaran dilanjutkan
- Pemutaran yang dijeda berlanjut di sebuah sesi.
- Pemutaran dihentikan
- Sebuah sesi berhenti memutar.
- Item yang diputar berubah
- Sebuah sesi berpindah ke film, episode, atau lagu lain.
- Sesi terhubung
- Klien Jellyfin membuka sesi di server.
- Sesi terputus
- Server menutup sesi sebuah klien.
- Terhubung
- Macro Deck terhubung ke server.
- Terputus
- Macro Deck kehilangan koneksi ke server.
Variabel7
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
jellyfin_active_sessions- Sesi yang sedang memutar atau dijeda di semua server sekaligus.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Apakah Macro Deck dapat menjangkau setiap server dan berapa banyak sesi yang memutar di sana.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Apakah sesuatu sedang diputar, dijeda, atau dimuat di perangkat. Menulis ke variabel putar atau jeda akan memutar atau menjeda.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- Judul, serial, album (atau musim), dan jenis media item di setiap perangkat.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- Posisi dan durasi dalam detik serta kemajuan dalam persen. Menulis ke posisi atau kemajuan akan melompat ke titik tersebut.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- Pengguna, klien, dan perangkat setiap sesi, serta apakah server sedang mengonversi media.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- Volume dan status bisu setiap perangkat, jika perangkat melaporkannya. Menulis ke variabel ini mengatur volume atau membisukan.
Widget2
Tambahkan ke deck Anda dari pemilih widget.
- Pemutar musik
- Menampilkan apa yang diputar di server atau perangkat, dengan gambar sampul, kemajuan, serta tombol putar, jeda, dan lewati. Barisnya menyesuaikan dengan lagu, episode, dan film.
- Sesi Jellyfin
- Menampilkan apa yang diputar di satu atau semua server Anda, dengan sampul atau poster, siapa yang memutar, di perangkat mana, dan sejauh mana kemajuannya.
Pertanyaan yang sering diajukan
Sebaiknya pakai kunci API atau nama pengguna dan kata sandi?
Kunci API disarankan: Macro Deck dapat melihat dan mengendalikan setiap sesi di server. Dengan nama pengguna dan kata sandi, Macro Deck hanya melihat sesi yang boleh dikendalikan akun tersebut. Kata sandi digunakan sekali untuk masuk dan tidak disimpan; Macro Deck hanya menyimpan token akses yang diberikan Jellyfin.
Bisakah lebih dari satu server dihubungkan?
Bisa. Tambahkan satu konfigurasi per server. Masing-masing memiliki variabelnya sendiri, dinamai sesuai konfigurasinya, dan menampilkan apakah server tersebut terhubung.
Mengapa perintah gagal di TV atau di browser?
Tidak semua klien Jellyfin mendukung setiap perintah. Macro Deck hanya mengirim apa yang dilaporkan klien dapat dilakukannya, sehingga perintah yang tidak dapat dijalankan gagal dengan pesan. Volume dan bisu biasanya hanya berfungsi di aplikasi Jellyfin, bukan di tab browser.
Apa yang terjadi jika server luring?
Macro Deck terus mencoba di latar belakang dan menampilkan masalah Server Jellyfin tidak dapat dijangkau di halaman Jellyfin pada Integrasi setelah beberapa percobaan gagal. Aksi untuk server tersebut gagal dengan pesan sampai server kembali.
Sebaiknya pakai pemicu Jellyfin atau pemicu Pemutar Musik?
Pemicu Pemutar Musik, seperti Pemutaran Dimulai di bawah Pemutar Musik, juga berjalan untuk Jellyfin, sekali untuk server dan sekali untuk perangkat. Untuk otomasi, pemicu Jellyfin adalah pilihan yang lebih baik: pemicu ini berjalan sekali per perangkat dan membawa informasi pengguna serta jenis media.
Lainnya di Musik dan audio
Spotify
Disertakan dengan Macro DeckKendalikan pemutaran Spotify, sukai lagu, kelola daftar putar, dan tampilkan apa yang diputar di deck Anda.
YouTube Music Desktop App
Disertakan dengan Macro DeckKendalikan YouTube Music Desktop App dari deck Anda: pemutaran, volume, peringkat, dan apa yang diputar.
WebNowPlaying
Disertakan dengan Macro DeckKendalikan musik dan video yang diputar di browser Anda dan tampilkan apa yang diputar, melalui ekstensi WebNowPlaying.
SoundPad
Disertakan dengan Macro DeckPutar suara dari daftar SoundPad, kendalikan rekaman, dan tampilkan suara yang diputar di deck Anda.
Voicemeeter
Disertakan dengan Macro DeckKendalikan gain, bisu, pengarahan, dan tombol makro Voicemeeter, Banana, atau Potato dari deck Anda.