{"id":20905227,"url":"https://github.com/yinyanghu/cuefix","last_synced_at":"2025-05-13T05:31:10.433Z","repository":{"id":57417774,"uuid":"282309007","full_name":"yinyanghu/cuefix","owner":"yinyanghu","description":"A simple tool to fix problematic CUE files. Enjoy your HiFi!","archived":false,"fork":false,"pushed_at":"2025-04-23T03:56:57.000Z","size":101,"stargazers_count":19,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-23T04:31:22.966Z","etag":null,"topics":["audio","hifi","metadata-editor","tool"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yinyanghu.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":"2020-07-24T20:20:55.000Z","updated_at":"2025-04-23T03:57:01.000Z","dependencies_parsed_at":"2022-08-30T09:30:49.808Z","dependency_job_id":null,"html_url":"https://github.com/yinyanghu/cuefix","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yinyanghu%2Fcuefix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yinyanghu%2Fcuefix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yinyanghu%2Fcuefix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yinyanghu%2Fcuefix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yinyanghu","download_url":"https://codeload.github.com/yinyanghu/cuefix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253882898,"owners_count":21978564,"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":["audio","hifi","metadata-editor","tool"],"created_at":"2024-11-18T13:23:30.406Z","updated_at":"2025-05-13T05:31:09.952Z","avatar_url":"https://github.com/yinyanghu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CueFix\n\n[![Python](https://img.shields.io/pypi/pyversions/cuefix.svg?style=plastic)](https://badge.fury.io/py/cuefix)\n[![PyPI](https://badge.fury.io/py/cuefix.svg)](https://badge.fury.io/py/cuefix)\n[![Travis-CI](https://travis-ci.com/yinyanghu/cuefix.svg)](https://travis-ci.com/github/yinyanghu/cuefix)\n[![Maintained](https://img.shields.io/maintenance/yes/2020.svg)](https://github.com/yinyanghu/cuefix)\n[![Downloads](https://pepy.tech/badge/cuefix)](https://pepy.tech/project/cuefix)\n[![Join the chat at https://gitter.im/cuefix/community](https://badges.gitter.im/cuefix/community.svg)](https://gitter.im/cuefix/community?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n![License](https://img.shields.io/github/license/yinyanghu/cuefix)\n\nCueFix is simple command-line tool to fix CUE files which are popular in lossless audio / albums.\n\nCueFix provides the following functionalities:\n\n- automatically detect encoding of CUE file: GB2312, GBK, GB18030, UTF-8, UTF-8 BOM, and SHIFT-JIS\n- convert encoding of CUE file: support GB2312, UTF-8, UTF-8 BOM, etc.\n- convert newline format of CUE file: support Windows CRLF and Unix LF\n- scan the directory and fix not matched audio file in CUE file\n- backup the original CUE file so that users can revert the CUE file back\n- interactive with users to verify fixed CUE files\n\nPlease feel free to fork and contribute to the project if you like.\n\n## Installation\n\n### Prerequisites\n\nThe following dependencies are necessary:\n\n- Python 3.6 or above\n\n**Option 1: Install via pip**\n\nThe official release of `cuefix` is distributed on PyPI. Note that you should use the Python 3 version of `pip`:\n\n```bash\n$ pip3 install cuefix\n```\n\n**Option 2: Download from Github or git clone**\n\nThis is the recommended way for developers.\n\n```bash\n$ git clone git://github.com/yinyanghu/cuefix\n```\n\nRun `./setup.py install` to install `cuefix` to your user path.\n\n## Upgrading\n\nIf you install `cuefix` using `pip`, you could upgrade it via\n\n```bash\n$ pip3 install --upgrade cuefix\n```\n\n## Getting Started\n\n```\n$ cuefix -h\nusage: cuefix [-h] [--version] [-v] [-y] [-i] [--dryrun] [-e {utf-8-sig,utf-8,gb2312}] [-n {unix,windows}]\n              [--no-encoding] [--no-newline] [--no-backup]\n              filepath\n\nFix a CUE file in a directory: convert encoding, convert newline character, fix not matched audio file.\n\npositional arguments:\n  filepath              file path to the input cue file\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --version             print the version of cuefix and exit\n  -v, --verbose         enable verbose output\n\ndry-run options:\n  -y, --yes             disable interactive mode and yes to all prompts\n  -i, --info            display metainfo of the input cue file only\n  --dryrun              dry-run and print out fixed cue file\n\nfix options:\n  -e {utf-8-sig,utf-8,gb2312}, --encoding {utf-8-sig,utf-8,gb2312}\n                        encoding which cue file will be converted to, default is UTF-8 BOM (utf-8-sig)\n  -n {unix,windows}, --newline {unix,windows}\n                        newline format which cue file will be converted to, default is Unix\n  --no-encoding         converting encoding will be skipped\n  --no-newline          converting newline will be skipped\n\nbackup options:\n  --no-backup           no backup for the input cue file, USE WITH CAUTION!\n```\n\nYou can recursively run `cuefix` to fix all CUE file in a directory:\n\n```bash\n$ find \u003cdirectory\u003e -type f -name \"*.cue\" -exec cuefix -v {} \\;\n```\n\n## CUE Formats Supported by Popular Media Players\n\n### Media Players\n\n- [Foobar 2000](https://www.foobar2000.org/)\n  - Windows (version 1.5.5)\n- [DeaDBeeF](https://deadbeef.sourceforge.io/)\n  - Linux (version 1.8.4)\n  - Android\n  - Windows (unstable, nightly build)\n  - macOS (unstable, nightly build)\n- [VOX](https://vox.rocks/)\n  - macOS (version 3.3.17)\n  - iOS\n- [Synology Audio Station](https://www.synology.com/en-ca/dsm/feature/audio_station)\n  - Synology DSM (version 6.2.3)\n  - Audio Station (version 6.5.5-3374)\n\n### Encoding\n\nPlease use the following encoding name in `cuefix`:\n\n- UTF-8: `utf-8`\n- UTF-8 BOM: `utf-8-sig`\n- GB 2312: `gb2312`\n\n|                        |    Platform     |       UTF-8        |     UTF-8 BOM      |      GB 2312       |\n| :--------------------: | :-------------: | :----------------: | :----------------: | :----------------: |\n|      Foobar 2000       |     Windows     |        :x:         | :heavy_check_mark: | :heavy_check_mark: |\n|        DeaDBeeF        | Linux / Android | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |\n|          VOX           |   macOS / iOS   | :heavy_check_mark: | :heavy_check_mark: |        :x:         |\n| Synology Audio Station |   NAS / Linux   | :heavy_check_mark: | :heavy_check_mark: |        :x:         |\n\n\u003e Note: DeaDBeeF on Linux could support CUE file in encoding GB 2312 by enabling `Chinese CP 936 detection and recording` in the settings.\n\u003e However, DeaDBeeF on macOS still cannot support GB 2312 even if we enable the setting.\n\u003e DeadDBeeF on Android has not been tested yet.\n\n\u003e Note: VOX on iOS has not been tested yet.\n\n### Newline\n\n|                        |    Platform     |     Unix (LF)      |   Windows (CRLF)   |\n| :--------------------: | :-------------: | :----------------: | :----------------: |\n|      Foobar 2000       |     Windows     | :heavy_check_mark: | :heavy_check_mark: |\n|        DeaDBeeF        | Linux / Android | :heavy_check_mark: | :heavy_check_mark: |\n|          VOX           |   macOS / iOS   | :heavy_check_mark: | :heavy_check_mark: |\n| Synology Audio Station |   NAS / Linux   | :heavy_check_mark: | :heavy_check_mark: |\n\n## License\n\n[GNU General Public License v3.0](https://github.com/yinyanghu/cuefix/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyinyanghu%2Fcuefix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyinyanghu%2Fcuefix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyinyanghu%2Fcuefix/lists"}