GaanaDL CLI

1.4.0 verified Sat May 09 auth: no python

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.

pip install gaanadl-cli

Common errors

error ModuleNotFoundError: No module named 'gaanadl' ↓

cause The package is installed as `gaanadl-cli`, but import uses `gaanadl`.

fix

Ensure you have installed pip install gaanadl-cli. Then import as from gaanadl import GaanaDownloader.

error 'gaanadl' is not recognized as an internal or external command ↓

cause The CLI command is `gaana`, not `gaanadl`. Common confusion because package name differs from command.

fix

Use gaana command. Example: gaana --help.

Warnings

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

fix Use `gaana` command instead of `gaanadl`.

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

fix Use `from gaanadl import GaanaDownloader`.

deprecated FFmpeg 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`).

Imports

GaanaDownloader
wrong
```
from gaanadl_cli import GaanaDownloader
```
correct
```
from gaanadl import GaanaDownloader
```
Package name on PyPI is 'gaanadl-cli', but module name is 'gaanadl' (no hyphen). Import as 'gaanadl'.

Quickstart

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'