gaanadl-cli

library1.4.0pypypi✓ verified 81d ago

A Python CLI tool to download high-quality music from Gaana with metadata and synced lyrics. Supports tracks, albums, playlists, artist top tracks, trending, and new releases. Output formats include FLAC, ALAC, WAV, AIFF, MP3, AAC, M4A, Opus, OGG, Vorbis, WMA. Version 1.4.0 is latest, released Jan 2026. Active development.

data

pip install gaanadl-cli

github ↗package ↗

INSTALL

IMPORT

SIG · GAANADL-CLI

gaanadl-cli

datapythonv1.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GaanaDownloader

✓ from gaana import GaanaDownloader

✗ from gaanadl import GaanaDownloader

Basic usage: search for a song and download. CLI: `gaana -s 'shape of you'`.

from gaanadl import GaanaDownloader # Example: search and download client = GaanaDownloader() results = client.search('shape of you', limit=5) # gui or CLI usage; see CLI: gaana -s 'shape of you'

gaanadl --version

Debug

Known issues

gotchaThe package provides a CLI entry point `gaana`, not `gaanadl`. Using `gaanadl` as a command will fail.

fix

Use `gaana` command instead of `gaanadl`.

affects: >=1.0.0

gotchaThe Python module is `gaanadl`, but the CLI command is `gaana`. Importing `gaanadl` works; `from gaanadl import ...`.

fix

Use `from gaanadl import GaanaDownloader`.

affects: >=1.0.0

deprecatedFFmpeg is required for all output formats except raw HLS (m4a). Without ffmpeg, downloads will fail or produce broken files.

fix

Install FFmpeg (e.g., `sudo apt install ffmpeg` or `brew install ffmpeg`).

affects: >=1.0.0

Upgrade

Version history

1.4.0latest on PyPI · released Jan 13, 2026

Audit

Dependencies

requestsrequiredHTTP requests for Gaana API

richrequiredCLI output formatting

ffmpeg-pythonoptionalAudio conversion and metadata embedding

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/notdeltaxd/gaanadl-cli ↗

packagehttps://pypi.org/project/gaanadl-cli/ ↗