# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: QM-Music
spec:
    description: |
        A lightweight private music server based on the Subsonic protocol. Stream your music collection from anywhere with transcoding support, Chinese character search optimization, and compatibility with popular Subsonic clients.
    coverImage: https://github.com/user-attachments/assets/55019589-116b-4afd-ba90-dc0b7a704520
    icon: https://avatars.githubusercontent.com/u/15151483?s=200&v=4
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain to access QM-Music
        - key: PASSWORD
          type: PASSWORD
          name: Admin Password
          description: Password for the admin account
    tags:
        - Media
    readme: |
        # QM-Music

        A lightweight private music server based on the Subsonic protocol. Stream your personal music collection from anywhere with minimal resource usage (~150MB memory).

        ## What You Can Do After Deployment

        1. **Log in** — default credentials are `admin` / `admin`
        2. **Upload music** — go to Zeabur dashboard, select QM-Music service, open **Files** > **File Manager**, and upload music files to `/data/qm-music/music_dir`
        3. **Browse library** — the web UI auto-scans your music directory
        4. **Stream anywhere** — connect Subsonic-compatible apps (feishin, Amperfy, Symfonium, DSub)
        5. **Search music** — optimized for both simplified and traditional Chinese characters
        6. **Manage users** — create accounts with independent permissions

        ## Key Features

        - Subsonic API compatible with popular music clients
        - Intelligent audio transcoding (MP3, FLAC, AAC, WAV)
        - Minimal resource usage (~150MB memory)
        - Chinese character search optimization
        - Play history tracking and personalized playlists
        - Multi-user support with independent accounts
        - Optional Spotify metadata and Last.fm scrobbling integration

        ## Default Credentials

        - Username: `admin`
        - Password: `admin`

        > Change the default password immediately after first login.

        ## License

        Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    services:
        - name: qm-music
          icon: https://avatars.githubusercontent.com/u/15151483?s=200&v=4
          template: PREBUILT_V2
          spec:
            source:
                image: qmmusic/qm-music:v2.3.0
            ports:
                - id: web
                  port: 6688
                  type: HTTP
            volumes:
                - id: music
                  dir: /data/qm-music/music_dir
                - id: db
                  dir: /data/qm-music/db
                - id: cache
                  dir: /data/qm-music/cache
            env:
                QM_REFRESH_AUTO:
                    default: "true"
                TZ:
                    default: UTC
          domainKey: PUBLIC_DOMAIN
localization:
    es-ES:
        description: |
            Servidor de musica privado ligero basado en el protocolo Subsonic. Transmita su coleccion musical desde cualquier lugar con soporte de transcodificacion y compatibilidad con clientes Subsonic populares.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Dominio
              description: El dominio para acceder a QM-Music
            - key: PASSWORD
              type: STRING
              name: Contrasena de administrador
              description: Contrasena para la cuenta de administrador
        readme: |
            # QM-Music

            Servidor de musica privado basado en el protocolo Subsonic. Uso minimo de recursos (~150MB de memoria).

            ## Que puede hacer tras el despliegue

            1. **Iniciar sesion** — credenciales por defecto `admin` / `admin`
            2. **Subir musica** — desde el panel de Zeabur, seleccione QM-Music, abra **Archivos** > **Gestor de archivos** y suba archivos a `/data/qm-music/music_dir`
            3. **Explorar biblioteca** — la interfaz web escanea automaticamente su directorio de musica
            4. **Transmitir desde cualquier lugar** — conecte apps compatibles con Subsonic
            5. **Buscar musica** — optimizado para caracteres chinos
            6. **Gestionar usuarios** — crear cuentas con permisos independientes

            ## Credenciales por defecto

            - Usuario: `admin`
            - Contrasena: `admin`

            > Cambie la contrasena inmediatamente tras el primer inicio de sesion.

            ## Licencia

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    id-ID:
        description: |
            Server musik pribadi ringan berbasis protokol Subsonic. Streaming koleksi musik dari mana saja dengan dukungan transcoding dan kompatibilitas klien Subsonic populer.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Domain
              description: Domain untuk mengakses QM-Music
            - key: PASSWORD
              type: STRING
              name: Password Admin
              description: Password untuk akun admin
        readme: |
            # QM-Music

            Server musik pribadi berbasis protokol Subsonic. Penggunaan sumber daya minimal (~150MB memori).

            ## Yang Dapat Dilakukan Setelah Deploy

            1. **Login** — kredensial default `admin` / `admin`
            2. **Upload musik** — dari dashboard Zeabur, pilih layanan QM-Music, buka **Files** > **File Manager** dan upload file musik ke `/data/qm-music/music_dir`
            3. **Jelajahi library** — UI web otomatis memindai direktori musik
            4. **Streaming di mana saja** — hubungkan aplikasi kompatibel Subsonic
            5. **Cari musik** — dioptimalkan untuk karakter Cina
            6. **Kelola pengguna** — buat akun dengan izin independen

            ## Kredensial Default

            - Username: `admin`
            - Password: `admin`

            > Segera ubah password default setelah login pertama.

            ## Lisensi

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    ja-JP:
        description: |
            Subsonic プロトコルベースの軽量プライベート音楽サーバー。トランスコーディング対応、中国語検索最適化、主要 Subsonic クライアントと互換。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: ドメイン
              description: QM-Music にアクセスするためのドメイン
            - key: PASSWORD
              type: STRING
              name: 管理者パスワード
              description: 管理者アカウントのパスワード
        readme: |
            # QM-Music

            Subsonic プロトコルベースの軽量プライベート音楽サーバー。約 150MB のメモリで動作。

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

            1. **ログイン** — デフォルト認証情報 `admin` / `admin`
            2. **音楽をアップロード** — Zeabur ダッシュボードで QM-Music サービスを選択し、**ファイル** > **ファイルマネージャー**から音楽ファイルを `/data/qm-music/music_dir` にアップロード
            3. **ライブラリ閲覧** — Web UI が音楽ディレクトリを自動スキャン
            4. **どこでもストリーミング** — Subsonic 互換アプリ（feishin、Amperfy 等）で接続
            5. **音楽検索** — 中国語文字検索に最適化
            6. **ユーザー管理** — 独立した権限のアカウントを作成

            ## デフォルト認証情報

            - ユーザー名：`admin`
            - パスワード：`admin`

            > 初回ログイン後、すぐにパスワードを変更してください。

            ## ライセンス

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    ko-KR:
        description: |
            Subsonic 프로토콜 기반 경량 프라이빗 음악 서버. 트랜스코딩 지원, 중국어 검색 최적화, 주요 Subsonic 클라이언트 호환.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 도메인
              description: QM-Music에 접속할 도메인
            - key: PASSWORD
              type: STRING
              name: 관리자 비밀번호
              description: 관리자 계정 비밀번호
        readme: |
            # QM-Music

            Subsonic 프로토콜 기반 경량 프라이빗 음악 서버. 약 150MB 메모리로 동작.

            ## 배포 후 할 수 있는 것

            1. **로그인** — 기본 인증 정보 `admin` / `admin`
            2. **음악 업로드** — Zeabur 대시보드에서 QM-Music 서비스 선택, **파일** > **파일 관리**에서 음악 파일을 `/data/qm-music/music_dir`에 업로드
            3. **라이브러리 탐색** — Web UI가 음악 디렉토리를 자동 스캔
            4. **어디서나 스트리밍** — Subsonic 호환 앱 (feishin, Amperfy 등) 연결
            5. **음악 검색** — 중국어 문자 검색 최적화
            6. **사용자 관리** — 독립 권한 계정 생성

            ## 기본 인증 정보

            - 사용자 이름: `admin`
            - 비밀번호: `admin`

            > 첫 로그인 후 즉시 비밀번호를 변경하세요.

            ## 라이선스

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    th-TH:
        description: |
            เซิร์ฟเวอร์เพลงส่วนตัวน้ำหนักเบาบนโปรโตคอล Subsonic สตรีมคอลเลกชันเพลงจากทุกที่ รองรับทรานส์โค้ดดิ้งและเข้ากันได้กับไคลเอนต์ Subsonic ยอดนิยม
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: โดเมน
              description: โดเมนสำหรับเข้าถึง QM-Music
            - key: PASSWORD
              type: STRING
              name: รหัสผ่านแอดมิน
              description: รหัสผ่านสำหรับบัญชีแอดมิน
        readme: |
            # QM-Music

            เซิร์ฟเวอร์เพลงส่วนตัวบนโปรโตคอล Subsonic ใช้ทรัพยากรน้อย (~150MB หน่วยความจำ)

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

            1. **เข้าสู่ระบบ** — ข้อมูลเริ่มต้น `admin` / `admin`
            2. **อัปโหลดเพลง** — จากแดชบอร์ด Zeabur เลือกบริการ QM-Music เปิด **Files** > **File Manager** อัปโหลดไฟล์เพลงไปที่ `/data/qm-music/music_dir`
            3. **เรียกดูไลบรารี** — UI เว็บสแกนไดเรกทอรีเพลงอัตโนมัติ
            4. **สตรีมได้ทุกที่** — เชื่อมต่อแอปที่เข้ากันกับ Subsonic
            5. **ค้นหาเพลง** — ปรับแต่งสำหรับอักขระจีน
            6. **จัดการผู้ใช้** — สร้างบัญชีพร้อมสิทธิ์อิสระ

            ## ข้อมูลเข้าสู่ระบบเริ่มต้น

            - ชื่อผู้ใช้: `admin`
            - รหัสผ่าน: `admin`

            > กรุณาเปลี่ยนรหัสผ่านทันทีหลังเข้าสู่ระบบครั้งแรก

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

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    zh-CN:
        description: |
            基于 Subsonic 协议的轻量级私有音乐服务器。随处串流您的音乐收藏，支持转码、中文搜索优化，兼容主流 Subsonic 客户端。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 域名
              description: 访问 QM-Music 的域名
            - key: PASSWORD
              type: STRING
              name: 管理员密码
              description: 管理员账号的密码
        readme: |
            # QM-Music

            基于 Subsonic 协议的轻量级私有音乐服务器。内存仅需约 150MB，随处串流您的个人音乐收藏。

            ## 部署后可以做什么

            1. **登录** — 默认账号密码为 `admin` / `admin`
            2. **上传音乐** — 前往 Zeabur 控制台，选择 QM-Music 服务，打开 **文件** > **文件管理**，将音乐文件上传至 `/data/qm-music/music_dir`
            3. **浏览媒体库** — 网页界面自动扫描您的音乐目录
            4. **随处串流** — 连接 Subsonic 兼容应用（feishin、Amperfy、Symfonium、DSub）
            5. **搜索音乐** — 针对简繁中文优化
            6. **管理用户** — 创建拥有独立权限的账号

            ## 默认账号密码

            - 用户名：`admin`
            - 密码：`admin`

            > 首次登录后请立即更改默认密码。

            ## 许可证

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
    zh-TW:
        description: |
            基於 Subsonic 協議的輕量級私有音樂伺服器。隨處串流您的音樂收藏，支援轉碼、中文搜尋最佳化，相容主流 Subsonic 客戶端。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 網域
              description: 存取 QM-Music 的網域
            - key: PASSWORD
              type: STRING
              name: 管理員密碼
              description: 管理員帳號的密碼
        readme: |
            # QM-Music

            基於 Subsonic 協議的輕量級私有音樂伺服器。記憶體僅需約 150MB，隨處串流您的個人音樂收藏。

            ## 部署後可以做什麼

            1. **登入** — 預設帳號密碼為 `admin` / `admin`
            2. **上傳音樂** — 前往 Zeabur 控制台，選擇 QM-Music 服務，開啟 **檔案** > **檔案管理**，將音樂檔案上傳至 `/data/qm-music/music_dir`
            3. **瀏覽媒體庫** — 網頁介面自動掃描您的音樂目錄
            4. **隨處串流** — 連接 Subsonic 相容 App（feishin、Amperfy、Symfonium、DSub）
            5. **搜尋音樂** — 針對簡體和繁體中文最佳化
            6. **管理使用者** — 建立擁有獨立權限的帳號

            ## 預設帳號密碼

            - 使用者名稱：`admin`
            - 密碼：`admin`

            > 首次登入後請立即更改預設密碼。

            ## 授權條款

            Apache-2.0 — [GitHub](https://github.com/chenqimiao/qm-music)
