tidal-cli 1.0.0__py3-none-any.whl

ticli/tests/test_full_e2e.py

@@ -0,0 +1,70 @@
+"""End-to-end tests for Ticli CLI.
+
+Tests the CLI entry point and installed command via subprocess.
+"""
+
+import os
+import shutil
+import subprocess
+import sys
+
+import pytest
+from click.testing import CliRunner
+
+from ticli.cli import cli
+
+
+class TestCLIHelp:
+    """Test CLI help and basic invocation."""
+
+    def setup_method(self):
+        self.runner = CliRunner()
+
+    def test_main_help(self):
+        result = self.runner.invoke(cli, ["--help"])
+        assert result.exit_code == 0
+        assert "Ticli" in result.output
+
+    def test_quality_flag(self):
+        result = self.runner.invoke(cli, ["--help"])
+        assert result.exit_code == 0
+        assert "quality" in result.output.lower()
+
+    def test_quality_choices(self):
+        result = self.runner.invoke(cli, ["--help"])
+        assert result.exit_code == 0
+        assert "low" in result.output.lower()
+        assert "high" in result.output.lower()
+        assert "lossless" in result.output.lower()
+        assert "hires" in result.output.lower()
+
+
+class TestCLISubprocess:
+    """Test the installed CLI command via subprocess."""
+
+    @staticmethod
+    def _resolve_cli(name: str) -> str:
+        if os.environ.get("CLI_ANYTHING_FORCE_INSTALLED") == "1":
+            path = shutil.which(name)
+            if path:
+                return path
+            pytest.skip(f"{name} not found in PATH")
+        return None
+
+    def _run(self, args: list[str], **kwargs) -> subprocess.CompletedProcess:
+        exe = self._resolve_cli("ticli")
+        if exe:
+            cmd = [exe] + args
+        else:
+            cmd = [sys.executable, "-m", "ticli.cli"] + args
+        return subprocess.run(cmd, capture_output=True, text=True, timeout=10, **kwargs)
+
+    def test_help_exit_code(self):
+        result = self._run(["--help"])
+        assert result.returncode == 0
+        assert "Ticli" in result.stdout
+
+    def test_quality_in_help(self):
+        result = self._run(["--help"])
+        assert result.returncode == 0
+        assert "quality" in result.stdout.lower()

ticli/utils/__init__.py

@@ -0,0 +1 @@
+"""Utility modules for TIDAL CLI harness."""

ticli/utils/credential_store.py

@@ -0,0 +1,94 @@
+"""Secure credential storage for Ticli.
+
+Prefers the OS keychain (macOS Keychain, GNOME Keyring, Windows Credential Manager)
+via the `keyring` library. Falls back to a chmod-600 JSON file if keyring is
+unavailable.
+"""
+
+import json
+import logging
+import os
+from pathlib import Path
+from typing import Optional
+
+logger = logging.getLogger(__name__)
+
+SERVICE_NAME = "ticli"
+FALLBACK_DIR = Path.home() / ".config" / SERVICE_NAME
+FALLBACK_FILE = FALLBACK_DIR / "session.json"
+
+try:
+    import keyring
+    # Verify the backend isn't the fail-open "null" backend
+    _backend = keyring.get_keyring()
+    _backend_name = type(_backend).__name__
+    if "fail" in _backend_name.lower() or "null" in _backend_name.lower():
+        keyring = None
+        logger.debug("keyring backend is %s — falling back to file", _backend_name)
+except Exception:
+    keyring = None
+
+
+def _ensure_fallback_dir() -> None:
+    FALLBACK_DIR.mkdir(parents=True, exist_ok=True, mode=0o700)
+
+
+def save_tokens(data: dict) -> None:
+    """Persist OAuth tokens securely."""
+    payload = json.dumps(data)
+
+    if keyring is not None:
+        try:
+            keyring.set_password(SERVICE_NAME, "oauth_session", payload)
+            # Remove any leftover plaintext file from previous runs
+            _delete_fallback_file()
+            return
+        except Exception as e:
+            logger.warning("keyring.set_password failed, falling back to file: %s", e)
+
+    # Fallback: write to file with restrictive permissions
+    _ensure_fallback_dir()
+    FALLBACK_FILE.write_text(payload)
+    os.chmod(FALLBACK_FILE, 0o600)
+
+
+def load_tokens() -> Optional[dict]:
+    """Load stored OAuth tokens. Returns None if nothing is stored."""
+    # Try keychain first
+    if keyring is not None:
+        try:
+            raw = keyring.get_password(SERVICE_NAME, "oauth_session")
+            if raw:
+                return json.loads(raw)
+        except Exception as e:
+            logger.debug("keyring.get_password failed: %s", e)
+
+    # Fallback: read from file
+    if FALLBACK_FILE.exists():
+        try:
+            return json.loads(FALLBACK_FILE.read_text())
+        except (json.JSONDecodeError, OSError) as e:
+            logger.debug("Failed to read fallback token file: %s", e)
+
+    return None
+
+
+def delete_tokens() -> None:
+    """Remove stored OAuth tokens from all backends."""
+    if keyring is not None:
+        try:
+            keyring.delete_password(SERVICE_NAME, "oauth_session")
+        except Exception:
+            pass
+    _delete_fallback_file()
+
+
+def _delete_fallback_file() -> None:
+    """Remove the plaintext fallback file if it exists."""
+    try:
+        if FALLBACK_FILE.exists():
+            # Overwrite before unlinking for slightly better security
+            FALLBACK_FILE.write_bytes(b"\x00" * len(FALLBACK_FILE.read_bytes()))
+            FALLBACK_FILE.unlink()
+    except OSError:
+        pass

tidal_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: tidal-cli
+Version: 1.0.0
+Summary: Terminal music player for TIDAL — search, browse, queue, and stream lossless audio from your terminal
+Author: odonald
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/odonald/ticli
+Project-URL: Repository, https://github.com/odonald/ticli
+Project-URL: Issues, https://github.com/odonald/ticli/issues
+Project-URL: Funding, https://buymeacoffee.com/odonald
+Keywords: tidal,music,terminal,cli,player,tui,streaming,lossless,hifi
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tidalapi>=0.8.0
+Provides-Extra: keyring
+Requires-Dist: keyring>=24.0; extra == "keyring"
+Dynamic: requires-python
+
+# Ticli
+
+A terminal music player for TIDAL. Search, browse, queue, and play music — all from your terminal.
+
+Ticli connects directly to TIDAL's API using your premium account. No desktop app needed. Just authenticate, search, and play.
+
+Works on **macOS** and **Linux**.
+
+```
+╭──────────────────────── Ticli ────────────────────────╮
+│                                                        │
+│  ▶ ♥ Arlo Parks - Sophie                               │
+│     Super Sad Generation                               │
+│     1:47 ━━━━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3:28    │
+│     Queue: 3/12  LOSSLESS                              │
+│     Next: Cola • Arlo Parks                            │
+│                                                        │
+│  [space] play/pause  [n/→] next  [←] prev             │
+│  [s] search  [q] queue  [p] playlists                  │
+│  [l] like  [r] radio  [t] mini  [m] more               │
+│                                                        │
+╰────────────────────────────────────────────────────────╯
+```
+
+## Features
+
+- **Search** — Find tracks, albums, artists, and playlists
+- **Browse** — Navigate album and playlist tracklists
+- **Queue** — Manage your playback queue, reorder, remove tracks
+- **Playlists** — Browse and play your saved playlists
+- **Likes** — Toggle favorites on any track
+- **Radio** — Generate a station from any track
+- **Mini mode** — Condensed single-line display
+- **Session restore** — Picks up where you left off
+- **Lossless & Hi-Res** — Stream up to 24-bit/192kHz FLAC
+- **Secure auth** — OAuth tokens stored in your OS keychain
+
+## Install
+
+Requires Python 3.10+ and [ffmpeg](https://ffmpeg.org).
+
+```bash
+# macOS
+brew install ffmpeg python3
+pip install tidal-cli
+
+# Ubuntu / Debian
+sudo apt install ffmpeg python3-pip
+pip install tidal-cli
+```
+
+For secure token storage in your OS keychain (recommended):
+
+```bash
+pip install "tidal-cli[keyring]"
+```
+
+## Usage
+
+```bash
+ticli
+```
+
+On first run you'll get a URL to authorize with your TIDAL account. After that, your session is cached and you go straight to the player.
+
+### Quality
+
+```bash
+ticli --quality HIRES      # 24-bit hi-res FLAC
+ticli --quality LOSSLESS   # 16-bit FLAC
+ticli --quality HIGH       # lossless FLAC (default)
+ticli --quality LOW        # 320kbps
+```
+
+### Keybindings
+
+#### Player
+
+| Key | Action |
+|-----|--------|
+| `space` | Play / pause |
+| `n` `→` | Next track |
+| `←` | Previous track |
+| `s` | Search |
+| `q` | Queue |
+| `p` | Playlists |
+| `l` | Like / unlike track |
+| `r` | Start radio from track |
+| `t` | Toggle mini player |
+| `m` | Show more controls |
+| `esc` | Quit |
+
+#### Search
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate results |
+| `enter` `→` | Play track / open album or artist |
+| `backspace` | Delete character |
+| `esc` `←` | Back |
+
+#### Queue
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate |
+| `enter` | Jump to track |
+| `x` | Remove track |
+| `esc` `←` | Back |
+
+## How it works
+
+Ticli uses [tidalapi](https://github.com/tamland/python-tidal) to authenticate and fetch audio stream URLs. Audio is played through [ffplay](https://ffmpeg.org/ffplay.html). The TUI is built with [Rich](https://github.com/Textualize/rich).
+
+```
+┌─────────┐     OAuth      ┌───────────┐    stream URL    ┌───────────┐
+│  Ticli  │ ──────────────► │  TIDAL    │ ──────────────►  │  ffplay   │
+│  (TUI)  │ ◄────────────── │  API      │                  │           │
+└─────────┘    metadata     └───────────┘                  └───────────┘
+```
+
+### Auth & credentials
+
+OAuth tokens are stored in your OS keychain (macOS Keychain or GNOME Keyring). Falls back to `~/.config/ticli/session.json` with `0600` permissions if keyring is unavailable.
+
+## Requirements
+
+- macOS or Linux
+- Python 3.10+
+- TIDAL Premium subscription
+- ffmpeg
+
+## Support
+
+If you enjoy Ticli, consider [buying me a coffee](https://buymeacoffee.com/odonald).
+
+## License
+
+MIT

tidal_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+ticli/__init__.py,sha256=vIKekzWvFIuYxaaWDvCh5ZiUXmmfzS-kMzEgAqwl9jE,70
+ticli/cli.py,sha256=NMXEc7P7Q7ktGuOqxpngp5UpEgASOXtL0RmwnET0CrQ,453
+ticli/player.py,sha256=2mIXOoX82_u6io2ntOo5Iaq2uKWIKRtvPhMhrpFAC8E,57067
+ticli/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ticli/tests/test_full_e2e.py,sha256=gP_XC_3znSf7jmkEE_hGVhAIWI7ttMfGAfp-zmLsOYE,2037
+ticli/utils/__init__.py,sha256=DrvkIMwhPUNqvoHinCi1AsUGUlSlkqhy6WynhPG3oDQ,45
+ticli/utils/credential_store.py,sha256=cZc83IgXthCPUmmvbVzoxdkaZsJEj6ZVPwwan-xaJtU,2887
+tidal_cli-1.0.0.dist-info/METADATA,sha256=2sm0Xf9SSgtF61zWPOwLUzaC7TnI_28cRq7oxGOJJvQ,5892
+tidal_cli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tidal_cli-1.0.0.dist-info/entry_points.txt,sha256=ocr52-A7b6MV_1bQptxVNk1mFPkOHWJLOOWS-c1ZPas,41
+tidal_cli-1.0.0.dist-info/top_level.txt,sha256=3JHg4ScCRtEOG1Go5pzJhkYJWpjLS-CKgdnwwsMUH5k,6
+tidal_cli-1.0.0.dist-info/RECORD,,

tidal_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tidal_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ticli = ticli.cli:main

tidal_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ticli