# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: Yubal
spec:
    description: |
        Yubal is a self-hosted YouTube Music downloader with a web UI. Paste a link, get a tagged and organized music library. Supports playlist sync, artist/year sorting, duplicate detection, lyrics, and ReplayGain tagging. Media server ready for Navidrome, Jellyfin, and Gonic.
    coverImage: https://raw.githubusercontent.com/guillevc/yubal/master/docs/demo.gif
    icon: https://raw.githubusercontent.com/guillevc/yubal/master/packages/web/public/favicon.svg
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain to access Yubal
    tags:
        - Tool
        - Media
    readme: |
        # Yubal

        A self-hosted YouTube Music downloader that automatically tags, organizes, and syncs your music library. Paste any YouTube Music URL and get a clean, tagged collection organized by artist and album.

        ## What You Can Do After Deployment

        1. **Open your domain** — access the web UI to start downloading music
        2. **Paste a link** — enter any YouTube Music URL (track, album, or playlist)
        3. **Get organized files** — tracks are automatically tagged with metadata, lyrics, and cover art
        4. **Sync playlists** — subscribe to playlists for automatic scheduled sync of new tracks
        5. **Connect a media server** — point Navidrome, Jellyfin, or Gonic at the data volume for streaming

        ## Key Features

        - Web UI with real-time download progress and job queue
        - Albums, playlists, and individual track downloads
        - Scheduled playlist sync with duplicate detection
        - Automatic metadata tagging (artist, album, year, track number)
        - Synced lyrics (.lrc files) from lrclib.net
        - ReplayGain tagging for consistent playback volume
        - Format options — opus (best quality), mp3, or m4a
        - Smart deduplication — same track in multiple playlists stored once
        - Media server integration (Navidrome, Jellyfin, Gonic)

        ## License

        MIT — [GitHub](https://github.com/guillevc/yubal)
    services:
        - name: yubal
          icon: https://raw.githubusercontent.com/guillevc/yubal/master/packages/web/public/favicon.svg
          template: PREBUILT_V2
          spec:
            source:
                image: ghcr.io/guillevc/yubal:0.7.2
            ports:
                - id: web
                  port: 8000
                  type: HTTP
            volumes:
                - id: data
                  dir: /app/data
                - id: config
                  dir: /app/config
            env:
                YUBAL_AUDIO_FORMAT:
                    default: opus
                YUBAL_FETCH_LYRICS:
                    default: "true"
                YUBAL_REPLAYGAIN:
                    default: "true"
                YUBAL_SCHEDULER_CRON:
                    default: 0 0 * * *
                YUBAL_SCHEDULER_ENABLED:
                    default: "true"
                YUBAL_TZ:
                    default: UTC
            healthCheck:
                type: HTTP
                port: web
                http:
                    path: /
          domainKey: PUBLIC_DOMAIN
localization:
    es-ES:
        description: |
            Yubal es un descargador de YouTube Music autoalojado con interfaz web. Pega un enlace y obtén una biblioteca musical etiquetada y organizada. Soporta sincronización de playlists, ordenación por artista/año, detección de duplicados, letras y etiquetado ReplayGain.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Dominio
              description: El dominio para acceder a Yubal
        readme: |
            # Yubal

            Descargador de YouTube Music autoalojado que etiqueta, organiza y sincroniza automáticamente tu biblioteca musical.

            ## Qué puedes hacer después del despliegue

            1. **Visita tu dominio** — accede a la interfaz web para empezar a descargar música
            2. **Pega un enlace** — introduce cualquier URL de YouTube Music
            3. **Obtén archivos organizados** — las pistas se etiquetan automáticamente con metadatos y letras
            4. **Sincroniza playlists** — suscríbete para sincronización automática de nuevas pistas
            5. **Conecta un servidor de medios** — apunta Navidrome, Jellyfin o Gonic al volumen de datos

            ## Características

            - Interfaz web con progreso de descarga en tiempo real
            - Descarga de álbumes, playlists y pistas individuales
            - Sincronización programada con detección de duplicados
            - Etiquetado automático de metadatos
            - Letras sincronizadas (.lrc)
            - Etiquetado ReplayGain
            - Opciones de formato — opus, mp3 o m4a

            ## Licencia

            MIT — [GitHub](https://github.com/guillevc/yubal)
    id-ID:
        description: |
            Yubal adalah downloader YouTube Music self-hosted dengan antarmuka web. Tempel link, dapatkan perpustakaan musik yang sudah ditandai dan terorganisir. Mendukung sinkronisasi playlist, pengurutan artis/tahun, deteksi duplikat, lirik, dan penandaan ReplayGain.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Domain
              description: Domain untuk mengakses Yubal
        readme: |
            # Yubal

            Downloader YouTube Music self-hosted yang secara otomatis menandai, mengorganisir, dan menyinkronkan perpustakaan musik Anda.

            ## Apa yang bisa dilakukan setelah deploy

            1. **Buka domain** — akses antarmuka web untuk mulai mengunduh musik
            2. **Tempel link** — masukkan URL YouTube Music apa pun
            3. **Dapatkan file terorganisir** — trek ditandai otomatis dengan metadata dan lirik
            4. **Sinkronisasi playlist** — berlangganan untuk sinkronisasi otomatis trek baru
            5. **Hubungkan media server** — arahkan Navidrome, Jellyfin, atau Gonic ke volume data

            ## Fitur

            - Antarmuka web dengan progres unduhan real-time
            - Unduh album, playlist, dan trek individual
            - Sinkronisasi terjadwal dengan deteksi duplikat
            - Penandaan metadata otomatis
            - Lirik tersinkronisasi (.lrc)
            - Penandaan ReplayGain
            - Pilihan format — opus, mp3, atau m4a

            ## Lisensi

            MIT — [GitHub](https://github.com/guillevc/yubal)
    ja-JP:
        description: |
            YubalはセルフホストのYouTube Musicダウンローダーで、Web UIを備えています。リンクを貼り付けるだけで、タグ付けされ整理された音楽ライブラリが手に入ります。プレイリスト同期、アーティスト/年別整理、重複検出、歌詞、ReplayGainタグをサポート。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: ドメイン
              description: Yubalにアクセスするためのドメイン
        readme: |
            # Yubal

            セルフホストのYouTube Musicダウンローダー。自動タグ付け、整理、同期で音楽ライブラリを管理。YouTube MusicのURLを貼り付けるだけで、アーティスト・アルバムごとに整理されたコレクションが手に入ります。

            ## デプロイ後にできること

            1. **ドメインにアクセス** — Web UIで音楽ダウンロードを開始
            2. **リンクを貼り付け** — YouTube MusicのURL（トラック、アルバム、プレイリスト）を入力
            3. **整理されたファイル** — メタデータ、歌詞、カバーアートが自動タグ付け
            4. **プレイリスト同期** — プレイリストを登録して新曲を自動同期
            5. **メディアサーバー接続** — Navidrome、Jellyfin、Gonicでストリーミング

            ## 主な機能

            - Web UIでリアルタイムのダウンロード進捗表示
            - アルバム、プレイリスト、個別トラックのダウンロード
            - スケジュールプレイリスト同期と重複検出
            - 自動メタデータタグ付け
            - 同期歌詞（.lrcファイル）
            - ReplayGainタグ
            - opus、mp3、m4aから選択

            ## ライセンス

            MIT — [GitHub](https://github.com/guillevc/yubal)
    ko-KR:
        description: |
            Yubal은 셀프호스팅 YouTube Music 다운로더로 웹 UI를 제공합니다. 링크를 붙여넣으면 태그가 지정되고 정리된 음악 라이브러리를 얻을 수 있습니다. 플레이리스트 동기화, 아티스트/연도별 정렬, 중복 감지, 가사, ReplayGain 태그를 지원합니다.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 도메인
              description: Yubal에 접속할 도메인
        readme: |
            # Yubal

            셀프호스팅 YouTube Music 다운로더. 자동 태그, 정리, 동기화로 음악 라이브러리를 관리합니다.

            ## 배포 후 할 수 있는 것

            1. **도메인 접속** — 웹 UI에서 음악 다운로드 시작
            2. **링크 붙여넣기** — YouTube Music URL 입력
            3. **정리된 파일** — 메타데이터, 가사, 커버 아트 자동 태그
            4. **플레이리스트 동기화** — 구독하여 새 트랙 자동 동기화
            5. **미디어 서버 연결** — Navidrome, Jellyfin, Gonic으로 스트리밍

            ## 주요 기능

            - 웹 UI에서 실시간 다운로드 진행 상황 표시
            - 앨범, 플레이리스트, 개별 트랙 다운로드
            - 스케줄 플레이리스트 동기화와 중복 감지
            - 자동 메타데이터 태그
            - 동기화 가사 (.lrc 파일)
            - ReplayGain 태그
            - opus, mp3, m4a 형식 선택

            ## 라이선스

            MIT — [GitHub](https://github.com/guillevc/yubal)
    th-TH:
        description: |
            Yubal คือ YouTube Music downloader แบบ self-hosted พร้อม Web UI วางลิงก์แล้วได้คลังเพลงที่แท็กและจัดระเบียบเรียบร้อย รองรับซิงค์เพลย์ลิสต์ จัดเรียงตามศิลปิน/ปี ตรวจจับซ้ำ เนื้อเพลง และ ReplayGain
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: โดเมน
              description: โดเมนสำหรับเข้าถึง Yubal
        readme: |
            # Yubal

            YouTube Music downloader แบบ self-hosted ที่แท็ก จัดระเบียบ และซิงค์คลังเพลงอัตโนมัติ

            ## สิ่งที่ทำได้หลังจากติดตั้ง

            1. **เข้าสู่โดเมน** — เข้าถึง Web UI เพื่อเริ่มดาวน์โหลดเพลง
            2. **วางลิงก์** — ใส่ URL YouTube Music
            3. **ได้ไฟล์ที่จัดระเบียบ** — เพลงถูกแท็กอัตโนมัติพร้อมข้อมูลเมตา เนื้อเพลง และปก
            4. **ซิงค์เพลย์ลิสต์** — สมัครรับเพลงใหม่อัตโนมัติ
            5. **เชื่อมต่อ media server** — ชี้ Navidrome, Jellyfin หรือ Gonic ไปที่โวลุ่มข้อมูล

            ## ฟีเจอร์หลัก

            - Web UI แสดงความคืบหน้าการดาวน์โหลดแบบเรียลไทม์
            - ดาวน์โหลดอัลบั้ม เพลย์ลิสต์ และเพลงเดี่ยว
            - ซิงค์เพลย์ลิสต์ตามกำหนดเวลาพร้อมตรวจจับซ้ำ
            - แท็กข้อมูลเมตาอัตโนมัติ
            - เนื้อเพลงซิงค์ (.lrc)
            - แท็ก ReplayGain
            - เลือกรูปแบบ — opus, mp3 หรือ m4a

            ## สัญญาอนุญาต

            MIT — [GitHub](https://github.com/guillevc/yubal)
    zh-CN:
        description: |
            Yubal 是自托管的 YouTube Music 下载器，附带 Web 界面。粘贴链接即可获得已标记并整理好的音乐库。支持播放列表同步、歌手/年份分类、重复检测、歌词和 ReplayGain 标记。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 域名
              description: 访问 Yubal 的域名
        readme: |
            # Yubal

            自托管的 YouTube Music 下载器，自动标记、整理和同步你的音乐库。粘贴任何 YouTube Music 网址，即可获得按歌手和专辑整理的干净标记合集。

            ## 部署后可以做什么

            1. **打开域名** — 访问 Web 界面开始下载音乐
            2. **粘贴链接** — 输入任何 YouTube Music 网址
            3. **获得整理好的文件** — 曲目自动标记元数据、歌词和封面图
            4. **同步播放列表** — 订阅播放列表自动调度同步新曲目
            5. **连接媒体服务器** — 将 Navidrome、Jellyfin 或 Gonic 指向数据目录

            ## 主要功能

            - Web 界面，实时下载进度和任务队列
            - 专辑、播放列表和单曲下载
            - 调度播放列表同步与重复检测
            - 自动元数据标记
            - 同步歌词（.lrc 文件）
            - ReplayGain 标记
            - 格式选择 — opus、mp3 或 m4a

            ## 授权

            MIT — [GitHub](https://github.com/guillevc/yubal)
    zh-TW:
        description: |
            Yubal 是自架的 YouTube Music 下載器，附帶 Web 介面。貼上連結即可取得已標記並整理好的音樂庫。支援播放清單同步、歌手/年份分類、重複偵測、歌詞和 ReplayGain 標記。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 網域
              description: 存取 Yubal 的網域
        readme: |
            # Yubal

            自架的 YouTube Music 下載器，自動標記、整理和同步你的音樂庫。貼上任何 YouTube Music 網址，即可取得依歌手和專輯整理的乾淨標記合集。

            ## 部署後可以做什麼

            1. **開啟網域** — 存取 Web 介面開始下載音樂
            2. **貼上連結** — 輸入任何 YouTube Music 網址（曲目、專輯或播放清單）
            3. **取得整理好的檔案** — 曲目自動標記中繼資料、歌詞和封面圖
            4. **同步播放清單** — 訂閱播放清單自動排程同步新曲目
            5. **連接媒體伺服器** — 將 Navidrome、Jellyfin 或 Gonic 指向資料目錄串流

            ## 主要功能

            - Web 介面，即時下載進度和任務佇列
            - 專輯、播放清單和單曲下載
            - 排程播放清單同步與重複偵測
            - 自動中繼資料標記
            - 同步歌詞（.lrc 檔案）
            - ReplayGain 標記確保一致音量
            - 格式選擇 — opus、mp3 或 m4a
            - 智慧去重
            - 媒體伺服器整合

            ## 授權

            MIT — [GitHub](https://github.com/guillevc/yubal)