tidal-cli 1.0.0__tar.gz

tidal_cli-1.0.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,139 @@
+# 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/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tidal-cli"
+version = "1.0.0"
+description = "Terminal music player for TIDAL — search, browse, queue, and stream lossless audio from your terminal"
+license = "MIT"
+requires-python = ">=3.10"
+readme = {file = "README.md", content-type = "text/markdown"}
+authors = [
+    {name = "odonald"},
+]
+keywords = ["tidal", "music", "terminal", "cli", "player", "tui", "streaming", "lossless", "hifi"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Sound/Audio :: Players",
+]
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+    "tidalapi>=0.8.0",
+]
+
+[project.optional-dependencies]
+keyring = ["keyring>=24.0"]
+
+[project.urls]
+Homepage = "https://github.com/odonald/ticli"
+Repository = "https://github.com/odonald/ticli"
+Issues = "https://github.com/odonald/ticli/issues"
+Funding = "https://buymeacoffee.com/odonald"
+
+[project.scripts]
+ticli = "ticli.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["ticli", "ticli.*"]
+
+[tool.pytest.ini_options]
+testpaths = ["ticli/tests"]

tidal_cli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tidal_cli-1.0.0/setup.py

@@ -0,0 +1,31 @@
+"""Setup for ticli package."""
+
+from setuptools import find_packages, setup
+
+setup(
+    name="tidal-cli",
+    version="1.0.0",
+    description="Ticli - Terminal music player for TIDAL",
+    author="Ticli",
+    license="MIT",
+    packages=find_packages(include=["ticli", "ticli.*"]),
+    python_requires=">=3.10",
+    install_requires=[
+        "click>=8.0",
+        "rich>=13.0",
+        "tidalapi>=0.8.0",
+    ],
+    extras_require={
+        "keyring": ["keyring>=24.0"],
+    },
+    entry_points={
+        "console_scripts": [
+            "ticli=ticli.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)

tidal_cli-1.0.0/ticli/__init__.py

@@ -0,0 +1,3 @@
+"""Ticli - Terminal music player for TIDAL."""
+
+__version__ = "1.0.0"

tidal_cli-1.0.0/ticli/cli.py

@@ -0,0 +1,19 @@
+"""Ticli - Terminal music player for TIDAL."""
+
+import click
+
+
+@click.command()
+@click.option("--quality", default="HIGH", type=click.Choice(["LOW", "HIGH", "LOSSLESS", "HIRES"], case_sensitive=False), help="Audio quality")
+def cli(quality):
+    """Ticli - Terminal music player for TIDAL."""
+    from ticli.player import HeadlessTidalPlayer
+    HeadlessTidalPlayer(quality=quality).run()
+
+
+def main():
+    cli()
+
+
+if __name__ == "__main__":
+    main()