Raspberry Pi'de Sesli Kitap ve Podcast Kitaplığınızı Barındırma
Bu yazı, PiMyLifeUp - Hosting your Audiobook and Podcast Library on a Raspberry Pi kaynağından Türkçe'ye çevrilerek hazırlanmıştır.
Bu eğitimde, audiobookshelf yazılımını kullanarak sesli kitap kitaplığınızı bir Raspberry Pi üzerinde nasıl kendi kendinize barındıracağınızı göstereceğiz.
![]()
Audiobookshelf, tüm sesli kitaplarınızı ve podcast'lerinizi saklamak için bir yer sağlayan özel bir medya sunucusudur. Sesiniz için otomatik olarak meta veri ve kapak verisi getirmesiyle Plex gibi diğer medya sunucularına benzer.
Audiobookshelf, kutudan çıktığı gibi ARM cihazlar için destek sunar, yani Raspberry Pi'mizi bu yazılımı çalıştırmak için kullanabiliriz.
Raspberry Pi, 7/24 çalışır durumda tutması çok uygun fiyatlı olması sayesinde, sesli kitaplarınızı ve podcast'lerinizi kendi kendinize barındırmak için harika bir platformdur. Düşük güçlü olmasına rağmen, kitaplığınızı işlemek ve sunmak için hâlâ fazlasıyla yeterli performans vardır.
Bu yazılımın, podcast'leri doğrudan arayüzü üzerinden arama ve indirme yeteneği gibi başka güzel özellikleri de var. Hatta ona bir RSS beslemesi (feed) verebilirsiniz ve yeni bölümler yayınlandıkça otomatik olarak indirecektir.
Bunun yanı sıra, Audiobookshelf öncelikli olarak sesli kitaplarınızı saklamak için bir yer sağlamaya odaklansa da, e-Kitaplar için de bazı temel destekler sunar.
Bu yazılımın yalnızca 64-bit cihazlar için derlemeler sunduğunu lütfen unutmayın. Audiobookshelf'i kullanmak için Raspberry Pi'nizde 64-bit bir işletim sistemi çalıştırıyor olmanız gerekir.
Raspberry Pi'de Audiobookshelf Kurulumu ve Çalıştırılması
Sonraki birkaç bölümde, Audiobookshelf yazılımını Raspberry Pi'nize kurma ve çalıştırma sürecinde size rehberlik edeceğiz.
Bu sürecin tamamı, geliştirme ekibinin bir ARM Docker konteyneri sağlaması sayesinde zahmetsiz hale getirilmiştir.
Raspberry Pi'nizi Hazırlama
1. Audiobookshelf'i kurmaya başlamadan önce, Raspberry Pi'mizin güncel olduğundan emin olmalıyız.
Terminalde aşağıdaki komutları kullanarak güncel olmayan tüm paketleri güncelleyebilirsiniz.
sudo apt update
sudo apt upgrade -y
2. Bir sonraki adımınız, makinenize Docker kurmaktır. Kurulum sürecini basitleştirdiğinden, Audiobookshelf'i yönetmek ve çalıştırmak için bir Docker konteyneri kullanacağız.
Bunu daha önce kurmadıysanız, Raspberry Pi'ye Docker kurma rehberimizi şiddetle tavsiye ederiz.
3. Docker kurulduktan sonra, bir sonraki adımınız, Audiobookshelf'in meta verilerinin Raspberry Pi'nizde saklanacağı bir yer oluşturmaktır. Bu klasör aynı zamanda bu yazılımı yönetmek için kullanılacak Compose dosyasını da tutacağımız yerdir.
Terminalde mkdir komutunu kullanarak "/opt/stacks/audiobookshelf" konumunda bir dizin oluşturabilirsiniz.
sudo mkdir -p /opt/stacks/audiobookshelf
4. Yukarıdaki dizini oluşturduktan sonra, cd komutunu kullanarak içine geçmek isteyeceksiniz. Eğitimin geri kalanı için bu klasörde olmamız gerekiyor.
cd /opt/stacks/audiobookshelf
Bir Docker Compose Dosyası Oluşturma
5. Compose dosyasını saklamak için bir yer ayarladığımıza göre, terminalde aşağıdaki komutu çalıştırarak Nano metin editörünü kullanarak yazmaya başlayabiliriz. Nano, başlangıç seviyesi için harika bir terminal tabanlı metin editörüdür.
Bu dosya, Docker'ın Raspberry Pi'mizde Audiobookshelf konteynerini başlatmak için kullanacağı dosyadır.
sudo nano compose.yaml
6. Bu Compose dosyasının içine, aşağıdaki satırları doldurmak isteyeceksiniz. Bu satırlar, Audiobookshelf'in Raspberry Pi'nizde nasıl çalıştırılacağını ve erişebileceği verileri belirleyecek.
Ana makinenizdeki her sesli kitap veya podcast kitaplığı için bir volume belirlemek isteyeceksiniz. Bunları "volumes:" seçeneği altında şu biçimi kullanarak ayarlarsınız: "<HOSTPATH>:/<LIBRARYNAME>".
<HOSTPATH>: Bu, sesli kitap veya podcast kitaplığınızın ana makinenizde bulunduğu yoldur. Örneğin, bizimki "/home/pimylifeup/audiobooks" konumunda, bu yüzden kullanacağımız yol bu olacaktır.<LIBRARYNAME>: Sağ tarafta ise bunun Docker konteyneri içinde hangi yolda bulunması gerektiğidir. Genellikle, "audiobooks" gibi bu kitaplık için kullanmak istediğiniz adı belirtmek isteyeceksiniz.
Tüm sesli kitap ve podcast kitaplıklarınızı belirledikten sonra, belirtmek isteyeceğiniz bir yer tutucu daha olacak.
-
<TIMEZONE>: Bu yer tutucu, saat dilimi tanımlayıcısıyla değiştirilmelidir. Bu tanımlayıcıların bir listesini Wikipedia'da bulabilirsiniz. Örneğin, yaşadığımız yere göre, bu değer için "Australia/Hobart" kullanırdık; siz kendi saat diliminizi (örn. "Europe/Istanbul") kullanmalısınız.services:
audiobookshelf:
image: ghcr.io/advplyr/audiobookshelf:latest
ports:
- 13378:80
volumes:
-:/
- ./config:/config
- ./metadata:/metadata
environment:
- TZ=
restart: unless-stopped
Örneğin, aşağıda bir podcast ve sesli kitap kitaplığı ekledikten sonra dosyanızın nasıl görünebileceği gösterilmektedir.
services:
audiobookshelf:
image: ghcr.io/advplyr/audiobookshelf:latest
ports:
- 13378:80
volumes:
- /home/pimylifeup/audiobooks:/audiobooks
- /home/pimylifeup/podcasts:/podcasts
- ./config:/config
- ./metadata:/metadata
environment:
- TZ=<TIMEZONE>
restart: unless-stopped
7. Compose dosyasını doldurduktan sonra, CTRL + X, Y ve ardından ENTER tuşuna basarak Nano'dan kaydedip çıkabilirsiniz.
Raspberry Pi'nizde AudioBookShelf'i Başlatma
8. Raspberry Pi'mizde Audiobookshelf'i çalıştırmak için Docker kullanmanın önemli bir avantajı, yazılımı başlatmayı ve yönetmeyi çok kolay hale getirmesidir.
Bu sesli kitap kitaplığını çalışır hale getirmek için şimdi yapmanız gereken tek şey, terminalde aşağıdaki komutu kullanmaktır. Docker, Audiobookshelf'in en son sürümünü hemen indirip başlatacaktır.
Bu konteyneri başlatırken "-d" seçeneğini kullanıyoruz, böylece Docker başlatıldıktan sonra terminalden ayrılacaktır (detach).
docker compose up -d
Audiobookshelf Web Arayüzüne Erişim
9. Favori web tarayıcınızda, Audiobookshelf web arayüzüne erişmek için aşağıdaki adrese gitmek isteyeceksiniz.
Tek yapmanız gereken "<IPADRESI>" kısmını Raspberry Pi'nizin IP'siyle değiştirmektir. Bu eğitimi yerel olarak takip ediyorsanız, Pi'nizin IP'sini hostname komutunu kullanarak alabilirsiniz.
http://<IPADRESI>:13378
Kök (Root) Kullanıcıyla Oluşturma ve Giriş Yapma
10. Audiobookshelf'i ilk kez kullandığınızda, bir kök (root) kullanıcı oluşturmanız istenecektir. Bu kullanıcının Raspberry Pi'nizdeki sesli kitap kitaplığınız üzerinde tam kontrolü vardır, bu yüzden güvenli bir şifre belirlediğinizden emin olun (1.).
Bir kullanıcı adı ve şifre belirledikten sonra, "Submit" düğmesine tıklayın (2.).

11. Doğrudan giriş ekranına yönlendirileceksiniz.
Yeni kullanıcınızın bilgilerini yazın (1.) ve ardından giriş yapmak için "Submit" düğmesine tıklayın (2.).

Raspberry Pi'nizde İlk Sesli Kitap veya Podcast Kitaplığınızı Ekleme
12. Giriş yaptıktan sonra, "Libraries" sekmesine yönlendirileceksiniz. Şu anda Audiobookshelf medyanızın nerede olduğunu bilmiyor, bu yüzden bir kitaplık kurmamız gerekiyor.
Bu yazılıma ilk kitaplığınızı eklemeye başlamak için, "Add your first library" düğmesine tıklayın.

13. Kitaplık ekranı artık açık olduğuna göre, yapmak isteyeceğiniz ilk şey medya türünü ayarlamaktır (1.). Sesli kitaplar veya e-Kitaplar için "Books", podcast'ler için "Podcasts" kullanın.
Medya türü ayarlandıktan sonra, bir sonraki adımınız kitaplığınız için bir isim belirlemektir (2.). Bizim durumumuzda, bunu içinde sakladığımız medya türüne göre adlandıracağız, yani "Audiobooks".
Bir sonraki adımınız, medyanızın saklandığı dizini belirtmektir. Bizim durumumuzda, daha önce Docker Compose dosyasında ayarladığımız için "/audiobooks" (3.) yolunu kullanıyoruz.
Bu yeni kitaplığı kaydetmek için, "Save" düğmesine tıklayın (4.).

14. Audiobookshelf, verilen klasörler içinde bulunan tüm sesli kitapları otomatik olarak tarayacaktır.
İstediğiniz kadar kitaplık ekleyebilirsiniz; sadece ayrı klasörlere sahip olduklarından emin olun.

Son Adımlar
15. Bu eğitimi bir adım öteye taşımak için, Nginx reverse proxy gibi bir şey kurmayı düşünebilirsiniz. Bu, kurulumunuza SSL gibi şeyler eklemeyi çok daha kolay bir işlem haline getirecektir.
Port yönlendirme yapmak ve güvenlik duvarınızı açmak zorunda kalmaktan kaçınmayı tercih ederseniz, Tailscale gibi birçok başka harika çözüm de vardır. Tailscale, Raspberry Pi'niz ile aynı ağın üyesi olan diğer cihazlar arasında sorunsuz bir şekilde bir VPN oluşturmaya yardımcı olur.
Bir diğer popüler seçenek ise kendi alan adınızı ve bir Cloudflare Tunnel'ı kullanmaktır.
Raspberry Pi'de Audiobookshelf'i Güncelleme
1. Raspberry Pi'nizde Audiobookshelf'in en son sürümüne güncellemek için, bu rehberin başında Compose dosyasını yazdığımız dizine geçmeniz gerekir.
Aşağıda gösterildiği gibi, terminalde cd komutunu kullanarak bu dizine geçebilirsiniz.
cd /opt/stacks/audiobookshelf
2. Bu dosyaya geçtikten sonra, aşağıdaki komutu çalıştırarak sesli kitap kitaplığı yazılımının en son sürümünü çekmek için Docker kullanabilirsiniz.
Bu komut, varsa daha yeni bir sürümü indirecektir. Ancak, henüz mevcut konteyneri güncellemeyecektir.
docker compose pull
3. Docker'ın mevcut Audiobookshelf konteynerinizi en son sürüme taşımasını sağlamak için, yalnızca Docker Compose up komutunu yeniden çalıştırmanız yeterlidir.
Bu komut, imajın yeni bir sürümünün mevcut olduğunu algılayacak ve zaten çalışan konteyneri bu yeni sürümü kullanarak yeniden başlatacaktır.
docker compose up -d
Sonuç
Umarız bu eğitimin bu noktasında, Raspberry Pi'nizde Audiobookshelf'i başarıyla çalışır hale getirmişsinizdir.
Bu yazılım, Sesli Kitap veya podcast kitaplıklarınızı kendi kendinize barındırmanın en iyi yollarından biridir. Kitaplığınızı düzenlemeyi kolaylaştırmaya yardımcı olan özelliklerle doludur.
Audiobookshelf'i Pi'nizde çalıştırırken sorun yaşadıysanız, lütfen aşağıya yorum bırakın.