{"id":27787,"library":"gaanadl-cli","title":"GaanaDL CLI","description":"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.","status":"active","version":"1.4.0","language":"python","source_language":"en","source_url":"https://github.com/notdeltaxd/gaanadl-cli","tags":["gaana","music-downloader","cli","metadata","lyrics"],"install":[{"cmd":"pip install gaanadl-cli","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP requests for Gaana API","package":"requests","optional":false},{"reason":"CLI output formatting","package":"rich","optional":false},{"reason":"Audio conversion and metadata embedding","package":"ffmpeg-python","optional":true}],"imports":[{"note":"Package name on PyPI is 'gaanadl-cli', but module name is 'gaanadl' (no hyphen). Import as 'gaanadl'.","wrong":"from gaanadl_cli import GaanaDownloader","symbol":"GaanaDownloader","correct":"from gaanadl import GaanaDownloader"}],"quickstart":{"code":"from gaanadl import GaanaDownloader\n\n# Example: search and download\nclient = GaanaDownloader()\nresults = client.search('shape of you', limit=5)\n# gui or CLI usage; see CLI: gaana -s 'shape of you'","lang":"python","description":"Basic usage: search for a song and download. CLI: `gaana -s 'shape of you'`."},"warnings":[{"fix":"Use `gaana` command instead of `gaanadl`.","message":"The package provides a CLI entry point `gaana`, not `gaanadl`. Using `gaanadl` as a command will fail.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use `from gaanadl import GaanaDownloader`.","message":"The Python module is `gaanadl`, but the CLI command is `gaana`. Importing `gaanadl` works; `from gaanadl import ...`.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Install FFmpeg (e.g., `sudo apt install ffmpeg` or `brew install ffmpeg`).","message":"FFmpeg is required for all output formats except raw HLS (m4a). Without ffmpeg, downloads will fail or produce broken files.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Ensure you have installed `pip install gaanadl-cli`. Then import as `from gaanadl import GaanaDownloader`.","cause":"The package is installed as `gaanadl-cli`, but import uses `gaanadl`.","error":"ModuleNotFoundError: No module named 'gaanadl'"},{"fix":"Use `gaana` command. Example: `gaana --help`.","cause":"The CLI command is `gaana`, not `gaanadl`. Common confusion because package name differs from command.","error":"'gaanadl' is not recognized as an internal or external command"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}