{"id":13537159,"url":"https://github.com/dharple/detox","last_synced_at":"2025-06-16T22:07:41.370Z","repository":{"id":17869307,"uuid":"82884753","full_name":"dharple/detox","owner":"dharple","description":"Tames problematic filenames","archived":false,"fork":false,"pushed_at":"2024-12-28T15:48:16.000Z","size":1243,"stargazers_count":400,"open_issues_count":32,"forks_count":21,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-06-16T11:00:35.777Z","etag":null,"topics":["c","filenames-change"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dharple.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-23T04:38:21.000Z","updated_at":"2025-06-14T21:21:43.000Z","dependencies_parsed_at":"2024-04-06T01:38:36.358Z","dependency_job_id":"4382d56b-5728-4f88-b9ca-6f92b64693d5","html_url":"https://github.com/dharple/detox","commit_stats":{"total_commits":357,"total_committers":6,"mean_commits":59.5,"dds":0.1512605042016807,"last_synced_commit":"df0c0781b76c1f96b0018d8f376d4674f0cb607f"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/dharple/detox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dharple%2Fdetox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dharple%2Fdetox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dharple%2Fdetox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dharple%2Fdetox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dharple","download_url":"https://codeload.github.com/dharple/detox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dharple%2Fdetox/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260249964,"owners_count":22980765,"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":["c","filenames-change"],"created_at":"2024-08-01T09:00:55.750Z","updated_at":"2025-06-16T22:07:41.350Z","avatar_url":"https://github.com/dharple.png","language":"C","funding_links":[],"categories":["C","Content","\u003ca name=\"file-dir-cleanup\"\u003e\u003c/a\u003eClean up of files and directories","Command Line Tools"],"sub_categories":["Utilities"],"readme":"# Overview\n\n`detox` is a program that renames files to make them easier to work with under\nLinux and other Unix-like operating systems.  Spaces and various other unsafe\ncharacters (such as \"`$`\") get replaced with \"`_`\".  The upper portion of\nISO-8859-1 (Latin-1) can be transcoded to UTF-8, as can CP-1252.\n\nMore details are contained in the `detox.1` [man page].\n\n---\n\n# Notice for Package Maintainers\n\nVersion 2 and up have a new dependency for package builds: `pkg-config` or\n`pkgconf`.\n\nYou may also need to add a dependency on `libtool`.  Please let me know if you\ndo, by creating an [issue].  I'll update the docs accordingly.\n\nAlso, the default config file and translation tables are no longer prefixed\nwith `.sample`.\n\nPlease open an [issue] for any build problems encountered.  Thanks!\n\n# Notice for Everyone\n\nAs of version 3, `detox` will no longer try to transliterate all of Unicode\ninto the ASCII character space.  The focus will be on truly problematic\ncharacters.\n\nOlder releases and version-specific branches are still available if you need\nthat functionality.  During this transition, the old tables are also available\nin `table/legacy/`\n\n---\n\n# Runtime Notes\n\nThe most important option to learn is `-n`, aka `--dry-run`.  This will let you\nrun `detox` without actually changing any files, so that you can get an idea\nof what `detox` is all about.\n\nThe simplest way to run `detox` is to just run it on a directory containing\nfiles that need work:\n\n```\ndetox xfer_files/\n```\n\nYou can also just to specify the filename:\n\n```\ndetox my\\ bad\\ file.txt\n```\n\nYou can also specify recursion (this works best on directories):\n\n```\ndetox -r /music/transferred_from_elsewhere/\n```\n\n# Building Detox\n\nMany distributions include a copy of detox with their packages.  If you wish to\nbuild it from scratch, you'll need the following tools:\n\n- autoconf\n- automake\n- bison / yacc / byacc\n- flex / lex\n- gcc / clang\n- make\n- pkg-config / pkgconf\n\n## Prerequisites\n\nTo install the needed packages on Debian, Ubuntu, Mint, and other Debian\nderivatives, run:\n\n```\nsudo apt install autoconf automake bison flex gcc make pkg-config\n```\n\nTo install the needed packages on macOS, run:\n```\nbrew install autoconf automake bison flex gcc make pkg-config\n```\n\nOn FreeBSD, run:\n```\nsudo pkg install autoconf automake gcc pkgconf wget\n```\n\nOn NetBSD, run:\n```\nsudo pkgin install autoconf automake mozilla-rootcerts pkgconf wget\nsudo mozilla-rootcerts install\n```\n\nOn MSYS2, run:\n```\npacman -S --needed base-devel gcc git mingw-w64-x86_64-toolchain\n```\n\n## Install Stable from GitHub Package\n\nTo build a stable copy of `detox`, run:\n\n```\nwget https://github.com/dharple/detox/releases/download/v2.0.0/detox-2.0.0.tar.gz\ntar xzvf detox-2.0.0.tar.gz\ncd detox-2.0.0\n./configure\nmake\nmake install\n```\n\nIf that fails during the configure or make steps, run:\n```\nautoreconf --install\n./configure\nmake\nmake install\n```\n\n## Install Stable from Repository\n\nTo build a stable copy of `detox` from source, install the package `git`, then\nrun:\n\n```\ngit clone -b 1.x https://github.com/dharple/detox.git\ncd detox\nautoreconf --install\n./configure\nmake\nmake install\n```\n\n## Install Development from Repository\n\nTo build a development copy of `detox` from source, install the package `git`,\nthen run:\n\n```\ngit clone -b main https://github.com/dharple/detox.git\ncd detox\nautoreconf --install\n./configure\nmake\nmake install\n```\n\n## Uninstall\n\nTo remove a copy of `detox` that was installed via these methods, from the same\ndirectory that you ran `make install`, run:\n\n```\nmake uninstall\n```\n\n# Contact\n\nFor support, to report a defect, or to request a new feature, please use the\n[GitHub Issues system].\n\n[GitHub Issues system]: https://github.com/dharple/detox/issues/\n[issue]: https://github.com/dharple/detox/issues/\n[man page]: https://raw.githubusercontent.com/dharple/detox/main/man/detox.1.pdf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdharple%2Fdetox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdharple%2Fdetox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdharple%2Fdetox/lists"}