Cara menambahkan dan mengatur pustaka di Jellyfin: Panduan lengkap

Menambahkan pustaka ke Jellyfin memungkinkan Anda mengubah folder yang berisi film, acara TV, musik, foto, atau video pribadi menjadi katalog yang dapat dijelajahi. Sampul, sinopsis, musim, dan informasi yang terorganisir.Namun, agar hasilnya akurat, Jellyfin harus dapat mengakses folder tersebut dan mengetahui dengan pasti jenis konten apa yang terdapat di dalamnya.

Tidak masalah apakah file tersebut disimpan di Komputer lama yang masih berfungsihard drive eksternal atau NAS. Aturan dasarnya adalah jalur tersebut harus terlihat dari komputer, layanan, atau kontainer tempat Jellyfin berjalan. Folder yang dapat Anda buka dari komputer pribadi Anda mungkin tidak secara otomatis tersedia untuk server.

Sebaiknya pisahkan setiap kategori sebelum memulai. Film, serial TV, dan musik menggunakan struktur dan penyedia metadata yang berbeda. Membuat pustaka khusus untuk masing-masing kategori akan mengurangi kesalahan identifikasi dan mempermudah pemeliharaan di masa mendatang.

Apa itu perpustakaan di Jellyfin?

Perpustakaan adalah sebuah koleksi virtual yang terdiri dari satu atau lebih folderFile-file tersebut tetap berada di lokasi aslinya; Jellyfin hanya menganalisis jalurnya, menyimpan informasi tentang jalur tersebut dalam basis datanya, dan menampilkan hasilnya melalui aplikasinya.

Satu pustaka dapat menyertakan file dari beberapa lokasi. Misalnya, Anda dapat membuat pustaka bernama Film dan menyertakan folder dari drive internal Anda dan folder lain yang terletak di NAS. Keduanya akan muncul bersamaan di antarmuka, meskipun file-file tersebut masih tersimpan di perangkat yang berbeda.

Ini bukan berarti Anda harus mencampur kategori. Anda dapat menggabungkan beberapa folder film dalam satu perpustakaan film, tetapi bukan ide yang baik untuk menambahkan folder serial TV atau musik ke koleksi yang sama.

Cara mempersiapkan folder sebelum menambahkannya

Sebelum membuka panel Jellyfin, pastikan server dapat membaca folder tersebut. Jalur tersebut harus tetap dapat diakses setiap kali Jellyfin melakukan pemindaian atau mencoba memutar file.

Jika media berada di disk lokal, berikan izin kepada pengguna yang menjalankan Jellyfin. izin baca pada folder dan fileIzin tulis hanya diperlukan jika Anda ingin mengizinkan Jellyfin untuk menyimpan gambar, file NFO, atau data lain bersama dengan konten, atau jika Anda telah mengaktifkan penghapusan file.

Saat menggunakan sumber daya SMB atau NFS, sumber daya tersebut harus dipasang (mounted) pada sistem operasi server. Jellyfin dirancang untuk membaca langsung dari sistem file dan bukan untuk menyimpan kredensial folder jaringan yang diakses dari komputer lain.

Jika Anda sedang mempertimbangkan tempat untuk menyimpan koleksi besar, Anda dapat melihat opsi-opsi yang tersedia di sini. penyimpanan untuk NAS rumahanPastikan sumber daya tersebut terpasang secara otomatis setelah setiap reboot dan sebelum memulai Jellyfin.

Cara memasang folder media saat Jellyfin menggunakan Docker

Sebuah container tidak dapat secara otomatis melihat semua folder pada sistem host. Anda harus menambahkan volume yang menghubungkan lokasi sebenarnya ke jalur internal yang dapat diakses oleh Jellyfin.

Misalnya:

services:
  jellyfin:
    image: jellyfin/jellyfin
    volumes:
      - /mnt/multimedia/peliculas:/media/peliculas:ro
      - /mnt/multimedia/series:/media/series:ro

Dalam contoh ini, /mnt/multimedia/peliculas adalah rute tuan rumah dan /media/peliculas Ini adalah pustaka yang dapat dilihat Jellyfin di dalam kontainer. Oleh karena itu, saat membuat pustaka, Anda harus memilih:

/media/peliculas

Jangan masukkan jalur host di Jellyfin, karena Lokasi tersebut tidak ada di dalam kontainer.Akhiran :ro Pasang media dalam mode baca saja, yang cukup untuk memindai dan memutarnya. Gunakan akses tulis hanya jika Anda memerlukan Jellyfin untuk memodifikasi folder tersebut.

Jika folder tampak kosong meskipun sudah terpasang (mounted), periksa pengguna dan grup tempat kontainer berjalan. Kredensial mereka harus memiliki izin untuk menelusuri direktori dan membaca file.

Cara menambahkan library ke Jellyfin langkah demi langkah

Setelah folder dapat diakses, selesaikan langkah-langkah berikut dari akun administrator:

1. Buka antarmuka web Jellyfin.
2. Buka menu utama.
3. Memasuki Administrasi > Panel Kontrol.
4. Memilih Server > Pustaka.
5. Tekan Tambahkan perpustakaan media.
6. Pilih jenis konten.
7. Masukkan nama yang akan muncul di antarmuka.
8. Tekan simbolnya + untuk menambahkan folder.
9. Pilih rute atau masukkan secara manual.
10. Konfigurasikan bahasa dan negara metadata.
11. Tinjau opsi tambahan dan simpan perpustakaan.

Jellyfin akan mulai menganalisis file dan akan menampilkan bilah kemajuan. Koleksi kecil mungkin akan muncul hampir seketika, sementara koleksi besar akan membutuhkan lebih banyak waktu untuk mengidentifikasi konten dan mengunduh gambar.

Anda dapat terus menggunakan antarmuka selama proses berlangsung, meskipun sampul, musim, dan sinopsis akan muncul secara bertahap hingga proses selesai. pemindaian pertama perpustakaan.

Jenis konten apa yang sebaiknya Anda pilih?

Tipe tersebut menentukan bagaimana Jellyfin menginterpretasikan struktur folder dan penyedia mana yang digunakannya. Memilih tipe yang salah dapat menyebabkan film muncul sebagai episode atau seluruh serial ditampilkan sebagai beberapa video terpisah.

Jenis perpustakaan	Konten yang direkomendasikan
Film	Film fitur diorganisir secara individual berdasarkan judul dan tahun.
Seri	Program-program dibagi ke dalam folder seri, musim, dan episode.
Musik	Album dan lagu dengan tag internal yang terisi dengan benar.
Video musik	Video musik dan penampilan yang bukan bagian dari film atau serial.
Foto	Gambar-gambar pribadi diatur menggunakan folder.
Buku	Buku, komik, dan buku audio melalui add-on yang sesuai.
Video dan foto rumahan	Rekaman pribadi tanpa identifikasi film otomatis.

Jangan gunakan tipe tersebut Film dan serial campuranDokumentasi terkini menganggap metode ini sudah usang dan menyarankan untuk tidak menggunakannya karena menghasilkan hasil yang tidak dapat diandalkan. Jika sebuah folder berisi kedua kategori tersebut, pisahkan terlebih dahulu sebelum membuat pustaka.

Cara mengatur film, acara TV, dan musik.

Panduan ini berfokus pada penambahan rute ke server. Struktur penamaan lengkap dijelaskan dalam artikel tentang cara... Tambahkan dan atur film dan acara TV di JellyfinNamun, inilah aturan-aturan pentingnya.

Film

Setiap film harus memiliki foldernya sendiri dan, jika memungkinkan, mencantumkan judul dan tahunnya:

Peliculas/
└── Nombre de la película (2025)/
    └── Nombre de la película (2025).mkv

Tahun pembuatan membantu membedakan film remake dan judul dengan nama yang identik. Anda juga dapat menambahkan pengenal vendor untuk meningkatkan kecocokan:

Nombre de la película (2025) [tmdbid-ID]

Seri

Serial televisi sebaiknya dibagi menjadi beberapa musim dan menggunakan nomor episode yang mudah dikenali:

Series/
└── Nombre de la serie (2025)/
    ├── Season 01/
    │   ├── Nombre de la serie S01E01.mkv
    │   └── Nombre de la serie S01E02.mkv
    └── Season 02/
        └── Nombre de la serie S02E01.mkv

Musim 00 Biasanya file ini dikhususkan untuk episode spesial. Sebuah file dapat berisi beberapa episode berurutan menggunakan pola seperti... S01E01-E02.

Musik

Untuk musik, metadata yang tertanam dalam file lebih penting daripada namanya. Setiap folder seharusnya hanya berisi satu album.

Musica/
└── Artista/
    └── Álbum/
        ├── Canción 01.flac
        └── Canción 02.flac

Periksa kolom untuk artis, artis album, nama album, nomor trek, dan nomor disk sebelum melakukan pemindaian pertama.

Cara mengkonfigurasi metadata perpustakaan

Jellyfin memperoleh informasi dari penyedia seperti TMDb, OMDb, dan file NFO lokal. Selama pembuatan pustaka, Anda dapat memilih bahasa dan negara pilihan Digunakan untuk mengunduh judul, sinopsis, dan peringkat.

Bahasa dapat dikonfigurasi untuk setiap pustaka, sehingga koleksi anime, film Spanyol, atau film versi asli dapat menggunakan pengaturan yang berbeda dari yang lainnya.

File NFO lokal lebih diutamakan daripada penyedia jarak jauh. Jika Jellyfin terus menampilkan informasi usang setelah mengganti nama folder, periksa apakah file tersebut ada. .nfo yang memaksakan data tersebut.

Jika judul dikaitkan dengan karya yang salah, gunakan alat identifikasi item atau tambahkan pengidentifikasi ke nama folder, misalnya [tmdbid-ID], [imdbid-ID] o [tvdbid-ID]Kemudian, metadata-nya diperbarui lagi.

Untuk kasus yang lebih rumit, lihat caranya. Memecahkan masalah sampul album dan metadata di Jellyfin.

Cara menambahkan beberapa folder ke pustaka yang sama

Anda tidak perlu membuat pustaka terpisah untuk setiap disk. Jellyfin memungkinkan Anda menambahkannya. beberapa rute dengan tipe yang sama dan menampilkannya sebagai satu koleksi.

Sebagai contoh, sebuah perpustakaan film mungkin mencakup:

/media/disco-interno/peliculas
/media/nas/peliculas
/media/disco-usb/peliculas

Ketiga lokasi tersebut akan muncul bersamaan di bawah nama yang dipilih. Pengaturan ini berguna ketika koleksi Anda telah bertambah dan Anda perlu mendistribusikannya ke beberapa drive.

Hindari menambahkan folder induk dan salah satu subfoldernya secara bersamaan. Jika Anda menambahkan /media/peliculas dan juga /media/peliculas/animacionJellyfin dapat menganalisis konten yang sama dua kali dan menghasilkan duplikat.

Bagaimana cara agar pengguna dapat melihat perpustakaan baru?

Pengguna yang memiliki akses ke semua perpustakaan akan secara otomatis menerima koleksi baru. Namun, profil yang dikonfigurasi untuk hanya melihat perpustakaan tertentu tidak akan menerima koleksi baru tersebut. Mereka tidak mendapatkan akses secara otomatis..

Untuk mengabulkannya:

1. Buka Panel kontrol.
2. Memasuki Pengguna.
3. Pilih profil yang sesuai.
4. Membuka Akses ke perpustakaan.
5. Tandai perpustakaan baru tersebut.
6. Simpan perubahannya.

Langkah ini sangat penting terutama ketika Konfigurasi profil anak di Jellyfinkarena perpustakaan baru dapat tetap tersembunyi sampai ditinjau dan disahkan secara eksplisit.

Cara memperbarui atau menganalisis ulang sebuah pustaka.

Jellyfin menjalankan tugas terjadwal untuk mendeteksi perubahan, tetapi Anda juga dapat memulai pemindaian manual. Buka menu perpustakaan dan pilih opsi untuk menganalisis atau memperbaruinya.

Pemantauan waktu nyata memungkinkan Anda mendeteksi file baru atau yang dimodifikasi tanpa menunggu pemindaian berikutnya. Namun, fitur ini tidak berfungsi dengan semua sistem file. Sumber daya seperti NFS atau rclone mungkin tidak menghasilkan peristiwa yang diperlukan, sehingga Anda harus mengandalkan tugas terjadwal atau pemindaian manual.

Jika Anda hanya mengoreksi ID satu judul, tidak perlu menganalisis ulang seluruh koleksi. Perbarui metadata item yang terpengaruh untuk menghindari panggilan dan pemrosesan yang tidak perlu.

Cara memodifikasi atau menghapus pustaka

Dari Panel Kontrol > Pustaka Anda dapat membuka opsi koleksi untuk mengubah namanya, menambah atau menghapus folder, dan meninjau penyedia metadata-nya.

Sebelum menghapus sebuah path, periksa apakah path tersebut bukan satu-satunya lokasi untuk file tertentu. Jika Anda menggunakan NAS atau drive USB, pastikan juga bahwa perangkat tersebut terhubung: drive yang sementara tidak tersedia mungkin muncul sebagai path yang sudah tidak ada lagi.

Jangan melakukan tugas pemeliharaan atau pemindaian penuh saat penyimpanan jaringan terputus. Jellyfin mungkin menghapus item yang tidak dapat ditemukan dari katalog. File tidak akan dihapus dari NAS, tetapi Anda perlu memulihkan koneksi dan memindai ulang pustaka.

Kesalahan umum saat menambahkan pustaka ke Jellyfin

Folder tersebut tidak muncul di pemilih.

Proses Jellyfin tidak dapat melihat lokasi tersebut. Verifikasi bahwa drive telah terpasang dan bahwa pengguna layanan memiliki izin untuk menelusuri folder dan membaca file.

Jalur Docker tampak kosong.

Anda mungkin sudah memasukkan jalur host. Periksa volume yang telah dikonfigurasi dan pilih di Jellyfin. rute internal kontainer.

Pustaka sudah dibuat, tetapi tidak menampilkan file apa pun.

Periksa izin, tipe konten, dan struktur folder. Menurut dokumentasi resmi, dua alasan paling umum adalah izin yang salah dan organisasi yang tidak kompatibel dengan pemindai.

Film-film tersebut muncul dalam serial tersebut.

Anda menggunakan folder campuran atau memilih jenis yang salah. Pisahkan kategori dan buat pustaka khusus untuk film dan acara TV.

Judul yang sama muncul berulang kali.

Periksa apakah Anda telah menambahkan jalur yang tumpang tindih, seperti folder induk dan salah satu subfoldernya. Selain itu, periksa juga apakah sumber daya yang sama tidak dipasang menggunakan dua jalur yang berbeda.

Jellyfin mengunduh sampul atau sinopsis yang salah.

Perbaiki nama dan tahun, atau tambahkan ID vendor. Kemudian perbarui metadata untuk item yang terpengaruh.

File baru tidak muncul secara otomatis.

Mulailah pemindaian manual dan periksa tugas terjadwal. Jika folder menggunakan NFS, rclone, atau sistem lain yang tidak mendukung event, pemantauan waktu nyata mungkin tidak berfungsi.

Konten akan hilang saat NAS terputus.

Jellyfin memindai jalur tersebut saat tidak dapat diakses. Pulihkan mount, pastikan file terlihat kembali, dan pindai ulang pustaka.

Beberapa pengguna tidak dapat melihat perpustakaan baru.

Profil dengan akses terbatas memerlukan otorisasi manual. Buka akun pengguna, masuk ke Akses Perpustakaan, pilih koleksi, dan simpan perubahannya.

Musik tersebut tampaknya dikelompokkan secara tidak tepat.

Periksa tag internal file tersebut. Jellyfin terutama menggunakan metadata yang disematkan untuk mengidentifikasi artis, album, cakram, dan trek.

Menambahkan pustaka ke Jellyfin dengan benar melibatkan pemilihan tipe yang tepat, menentukan jalur yang dapat diakses dari server, dan mematuhi struktur yang diharapkan untuk setiap kelas konten. Sebagian besar masalah bukan disebabkan oleh pemutar itu sendiri, tetapi oleh... jalur tak terlihat, izin yang tidak memadai, atau nama yang tidak kompatibel.

Sebelum mengimpor koleksi besar, coba impor folder yang berisi dua atau tiga judul terlebih dahulu. Jika Jellyfin mengidentifikasinya dengan benar, perluas jalur atau pindahkan file yang tersisa. Pemeriksaan ini mencegah Anda harus mengoreksi ratusan item setelah pemindaian awal.