{"id":13961426,"url":"https://github.com/evan-goode/mania","last_synced_at":"2025-07-28T21:33:00.898Z","repository":{"id":52217418,"uuid":"99532931","full_name":"evan-goode/mania","owner":"evan-goode","description":"👻 A command-line tool for downloading music from TIDAL","archived":false,"fork":false,"pushed_at":"2022-08-02T23:45:51.000Z","size":198,"stargazers_count":36,"open_issues_count":1,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-28T07:34:30.715Z","etag":null,"topics":["downloader","music","tidal","tidalapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evan-goode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-07T03:26:31.000Z","updated_at":"2024-09-28T02:19:45.000Z","dependencies_parsed_at":"2022-08-24T04:01:31.472Z","dependency_job_id":null,"html_url":"https://github.com/evan-goode/mania","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan-goode%2Fmania","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan-goode%2Fmania/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan-goode%2Fmania/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evan-goode%2Fmania/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evan-goode","download_url":"https://codeload.github.com/evan-goode/mania/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227960632,"owners_count":17847824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["downloader","music","tidal","tidalapi"],"created_at":"2024-08-08T17:01:07.648Z","updated_at":"2024-12-03T16:42:22.767Z","avatar_url":"https://github.com/evan-goode.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# ⚠️ No longer maintained.\nCheck out https://github.com/yarrm80s/orpheusdl and https://github.com/Dniel97/orpheusdl-tidal instead.\n\n## Mania 👻\n\nMania is a command-line tool for downloading music from [TIDAL](https://tidal.com). It is intended for educational and private use only, and **not** as a tool for pirating and distributing music.\n\n## Installation\n\n```\npip3 install --user --upgrade \"https://github.com/evan-goode/mania/archive/master.zip\"\n```\n\nMania requires Python 3.6 or higher and has been tested on GNU/Linux and macOS.\n\n## Usage\n\nInstead of asking for your username and password, Mania now uses TIDAL's TV login process. The first time you run it, it will ask you to link a TIDAL account. Simply follow the link it gives you and log in.\n\nTo download a track, an album, or even an artist's entire discography:\n\n```\nmania track the great gig in the sky\nmania album the dark side of the moon\nmania artist pink floyd\n```\n\nTo include EPs and singles in the discography:\n\n```\nmania artist pink floyd --include-eps-singles\n```\n\nYou can also give it a URL to something in the TIDAL catalog and Mania will try to parse it:\n\n```\nmania url https://tidal.com/browse/track/140538043\n```\n\nOptional flags can go anywhere in the command. For example, to automatically select the top search result:\n\n```\nmania track the great gig in the sky --lucky\n```\n\n## Configuration\n\nEach option (except `--config-file`) can be specified either as a command-line argument or using the TOML config file at `~/.config/mania/config.toml`. On the command line, prefix the option with `--`, or `--no-`, as in `--output-directory ~/music` or `--no-full-structure`.\n\nThe first time it's run, Mania populates `~/.config/mania/config.toml` with some default values. For more information on the TOML format, see https://github.com/toml-lang/toml.\n\nTo point Mania to a different configuration file, use `--config-file \u003cfile\u003e`.\n\nAvailable options are:\n\n- `quality \u003cquality\u003e`: default value is `lossless`. Possible values are `master` (MQA in a FLAC container, usually 96 kHz, 24 bit), `lossless` (44.1 kHz, 16 bit FLAC), `high` (~320 kbps VBR AAC), and `low` (~96 kbps VBR AAC). If the content you request isn't available in the specified quality, Mania will try to download the \"next best\" option (`master` \u003e `lossless` \u003e `high` \u003e `low`). Note that `master` and `lossless` require a TIDAL HiFi subscription.\n- `output-directory \u003cpath\u003e`: where to put downloaded music. Default value is `.` (your working directory when you run Mania).\n- `by-id`: find something using its ID instead of searching TIDAL. For example, `mania album --by-id 79419393`.\n- `lucky`: automatically download the top search result. Default value is `false`.\n- `search-count \u003cnumber\u003e`: how many results to include in the search. Default value is `16`.\n- `quiet`: don't log any output. Default value is `false`.\n- `nice-format`: rename downloaded material to follow kebab-case and strip out special characters. \"Maxwell's Silver Hammer (Remastered).mp3\" becomes \"maxwells-silver-hammer-remastered.mp3\". Default value is `false`.\n- `full-structure`: always organize content by artist and album. For example, `mania track --full-structure --lucky \"isn't she lovely\"` would create `Stevie Wonder/Songs In The Key Of Life/Disc 2/01 Isn't She Lovely.flac`. Default value is `false`.\n- `skip-metadata`: don't download cover art or set tags. Not sure why someone would want this. Overrides `replay-gain`. Default value is `false`.\n- `replay-gain`: tag FLAC files with [ReplayGain](https://en.wikipedia.org/wiki/ReplayGain) data from TIDAL (for normalization). Overridden by `skip-metadata`. Default value is `true`.\n- `include-eps-singles`: include EPs and singles when downloading discographies with `mania artist`. Default value is `false`; prolific artists can have a _lot_ of singles/remixes and often you just want the studio albums.\n- `track-format`: filename format for tracks. Default value is `{track_number} {track_name}`.\n- `individual-track-format`: filename format for tracks when a track is downloaded without the rest of the album. `full-structure` will force the use of the long format. Default value is `{track_name}`\n- `album-format`: filename format for albums. Default value is `{album_name}`.\n- `individual-album-format`: filename format for albums when an album is downloaded without the rest of the artist's discography. `full-structure` will force the use of the long format. Default value is `{album_name}`, the same as the default `album-format`. These options are kept distinct in case you want to, for example, include the year only for albums in a discography.\n\n### Formatting Variables\n\nThe following variables are available for use in the `*-format` options. All are surrounded with `{}`:\n\n- `{track_id}`: the ID of the track in TIDAL\n- `{track_name}`\n- `{track_artists}`: \", \"-delimited list of artists\n- `{track_first_artist}`: the first listed artist\n- `{track_number}`: number of the track in the album. Automatically zero-padded according to the total number of tracks.\n- `{album_id}`: the ID of the album in TIDAL\n- `{album_name}`\n- `{album_artists}`: comma +  delimited list of album artists\n- `{album_first_artist}`: the first listed album artist\n- `{album_year}`: the year of release, or `Unknown Year`\n\nFor example:\n\n```\nmania track the great gig in the sky --lucky --individual-track-format \"{track_artists} - {track_name} ({album_year})\"\n```\n\nwill download:\n\n```\nPink Floyd - The Great Gig in the Sky (1973).flac\n```\n\n## License\n\n[The Unlicense](https://unlicense.org)\n\n## See also\n\n- [tidalapi](https://github.com/tamland/python-tidal)\n- [RedSea](https://github.com/Dniel97/RedSea)\n- [Tidal-Media-Downloader](https://github.com/yaronzz/Tidal-Media-Downloader/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevan-goode%2Fmania","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevan-goode%2Fmania","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevan-goode%2Fmania/lists"}