{"id":20431491,"url":"https://github.com/jonthysell/asciirename","last_synced_at":"2025-06-22T10:36:46.958Z","repository":{"id":57818004,"uuid":"528198457","full_name":"jonthysell/AsciiRename","owner":"jonthysell","description":"Transliterate Unicode filenames into ASCII equivalents.","archived":false,"fork":false,"pushed_at":"2024-09-05T03:21:13.000Z","size":609,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-05T05:44:55.865Z","etag":null,"topics":["ascii","filename-utils","filenames","tool","unicode"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonthysell.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2022-08-23T23:42:48.000Z","updated_at":"2024-09-05T03:21:17.000Z","dependencies_parsed_at":"2024-11-15T08:12:09.659Z","dependency_job_id":"791d97c8-f0ee-4f00-9b3e-7c5788f3b98c","html_url":"https://github.com/jonthysell/AsciiRename","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/jonthysell/AsciiRename","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonthysell%2FAsciiRename","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonthysell%2FAsciiRename/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonthysell%2FAsciiRename/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonthysell%2FAsciiRename/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonthysell","download_url":"https://codeload.github.com/jonthysell/AsciiRename/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonthysell%2FAsciiRename/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261280131,"owners_count":23134902,"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":["ascii","filename-utils","filenames","tool","unicode"],"created_at":"2024-11-15T08:12:01.369Z","updated_at":"2025-06-22T10:36:41.938Z","avatar_url":"https://github.com/jonthysell.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AsciiRename #\r\n\r\n[![CI Build](https://github.com/jonthysell/AsciiRename/actions/workflows/ci.yml/badge.svg)](https://github.com/jonthysell/AsciiRename/actions/workflows/ci.yml)\r\n\r\nAsciiRename is a small command-line tool for renaming files with Unicode filenames into transliterated ASCII equivalents.\r\n\r\nIt was made primarily to assist with managing media files destined for devices with no/limited support for Unicode filenames.\r\n\r\nAsciiRename relies on [AnyAscii](https://github.com/anyascii/anyascii) to perform the transliteration and [libpu8](https://github.com/jofeu/libpu8) to build cross-platform on both Windows and Linux systems.\r\n\r\n## Installation ##\r\n\r\n### Windows ###\r\n\r\nThe Windows release provides self-contained x86/x64 binaries which run on Windows.\r\n\r\n1. Download the latest Windows zip file from https://github.com/jonthysell/AsciiRename/releases/latest\r\n2. Extract the zip file\r\n\r\n**Note:** If you're unsure which version to download, try x64. Most modern PCs are 64-bit.\r\n\r\n### MacOS ###\r\n\r\nThe MacOS release provides self-contained x64 binaries which run on OSX.\r\n\r\n1. Download the latest MacOS tar.gz file from https://github.com/jonthysell/AsciiRename/releases/latest\r\n2. Extract the tar.gz file\r\n\r\n### Linux ###\r\n\r\nThe Linux release provides self-contained x64 binaries which run on many Linux distributions.\r\n\r\n1. Download the latest Linux tar.gz file from https://github.com/jonthysell/AsciiRename/releases/latest\r\n2. Extract the tar.gz file\r\n\r\n## Usage ##\r\n\r\n```none\r\nUsage: ascii-rename [options...] [paths...]\r\n-h, --help       Show this help and exit\r\n-n, --no-op      Show what would happen but don't actually rename path(s)\r\n-o, --overwrite  Overwrite existing paths(s)\r\n-r, --recursive  Rename files and subdirectories recursively\r\n-v, --verbose    Make the output more verbose\r\n-V, --version    Show version number and exit\r\n```\r\n\r\n## Build ##\r\n\r\nThis project requires CMake \u003e= 3.16 and a standard C++ build environment.\r\n\r\n### Windows (VS) ###\r\n\r\nOpen VS Command Prompt, then run one of the following:\r\n\r\n* Build Debug: `.\\scripts\\build-debug.cmd`\r\n* Build Release: `.\\scripts\\build-release.cmd`\r\n\r\n### Linux (GCC) / MacOS (AppleClang) ###\r\n\r\n* Build Debug: `./scripts/build-debug.sh`\r\n* Build Release: `./scripts/build-release.sh`\r\n\r\n### General ###\r\n\r\n```\r\nmkdir build\r\ncd build\r\ncmake ..\r\ncmake --build .\r\n```\r\n\r\n## Errata ##\r\n\r\nAsciiRename is open-source under the MIT license.\r\n\r\nCopyright (c) 2022-2024 Jon Thysell\r\n\r\nAnyAscii Copyright (c) 2020-2023, Hunter WB \u003chunterwb.com\u003e\r\n\r\nlibpu8 Copyright (c) 2019, jofeu\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonthysell%2Fasciirename","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonthysell%2Fasciirename","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonthysell%2Fasciirename/lists"}