{"id":20767799,"url":"https://github.com/decaded/epub-renamer","last_synced_at":"2026-04-07T16:32:05.589Z","repository":{"id":196756925,"uuid":"697066072","full_name":"Decaded/epub-renamer","owner":"Decaded","description":"This script is designed to rename ePub files in folders based on specific criteria. It searches for folders containing ePub files and renames them according to the folder's name.","archived":false,"fork":false,"pushed_at":"2024-05-16T22:41:55.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-01T17:48:19.232Z","etag":null,"topics":["automation","bash-script","ebook","epub","linux","python3","rename-files","ubuntu","windows"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/Decaded.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"Decaded","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-09-27T01:38:44.000Z","updated_at":"2024-08-27T15:08:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"e3750c54-5e1d-4ca5-bd1f-decc75cc45e1","html_url":"https://github.com/Decaded/epub-renamer","commit_stats":{"total_commits":6,"total_committers":1,"mean_commits":6.0,"dds":0.0,"last_synced_commit":"5828c805bea6383844a905e6b91f28b53d24c780"},"previous_names":["decaded/epub-renamer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Decaded/epub-renamer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Decaded%2Fepub-renamer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Decaded%2Fepub-renamer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Decaded%2Fepub-renamer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Decaded%2Fepub-renamer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Decaded","download_url":"https://codeload.github.com/Decaded/epub-renamer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Decaded%2Fepub-renamer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31520483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automation","bash-script","ebook","epub","linux","python3","rename-files","ubuntu","windows"],"created_at":"2024-11-17T11:33:27.241Z","updated_at":"2026-04-07T16:32:05.569Z","avatar_url":"https://github.com/Decaded.png","language":"Shell","funding_links":["https://ko-fi.com/Decaded"],"categories":[],"sub_categories":[],"readme":"# Epub File Renamer Script\r\n\r\nThis handy script is here to make renaming ePub files a breeze. It's designed to help you organize your digital book collection by following a specific naming pattern. Let's\r\ndive into it!\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://github.com/Decaded/epub-renamer\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/languages/code-size/Decaded/epub-renamer\" alt=\"Code Size\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/Decaded/epub-renamer/issues\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/issues/Decaded/epub-renamer\" alt=\"Open Issues\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/Decaded/epub-renamer/pulls\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/issues-pr/Decaded/epub-renamer\" alt=\"Open PRs\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/Decaded/epub-renamer/commits\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/last-commit/Decaded/epub-renamer\" alt=\"Last Commit\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n## Features\r\n\r\n- **Automatic Renaming**: The script renames ePub files based on this naming pattern: `[folder name] v[XX].epub`, where `[XX]` is a two-digit volume number.\r\n- **Skip Existing Names**: If a folder already follows this naming pattern, it won't be renamed.\r\n- **User-Friendly**: Handles cases where it can't detect the volume number and asks for your input. You can also skip renaming in such cases.\r\n- **Informative Messages**: The script provides clear and helpful messages during the renaming process.\r\n- **Folder Listing**: It lists the folders it finds for processing in a user-friendly bullet point format.\r\n\r\n## Bash version\r\n\r\n1. **Download the Script**: Click [here](https://raw.githubusercontent.com/Decaded/epub-renamer/master/Bash/renamer.sh) to download the script. Place it in the root folder where you\r\n   have folders with files you want to rename.\r\n\r\n- You can also use `wget`:\r\n\r\n```sh\r\nwget https://raw.githubusercontent.com/Decaded/epub-renamer/master/Bash/renamer.sh\r\n```\r\n\r\n2. **Make it Executable**: Open your terminal and navigate to the script's folder. Run this command to make the script executable:\r\n\r\n```sh\r\nchmod +x renamer.sh\r\n```\r\n\r\n3. **Run the Script**: Execute the script with:\r\n\r\n```sh\r\n./renamer.sh\r\n```\r\n\r\n## Python version (Linux and Windows)\r\n\r\nIf you prefer using Python, you can also utilize the script provided in the `./Python` folder. Follow the steps below to rename your ePub files using Python:\r\n\r\n1. **Download the Python Script**: Navigate to the [Python folder](./Python) in the project repository and download the `renamer.py` file. \r\nOr you can use the following commands in your terminal or command prompt:\r\n\r\n  - **For Linux**:\r\n\r\n  ```sh\r\n  wget https://raw.githubusercontent.com/Decaded/epub-renamer/master/Python/renamer.py\r\n  ```\r\n  - **For Windows**:\r\n\r\n  ```curl\r\n  curl -O https://raw.githubusercontent.com/Decaded/epub-renamer/master/Python/renamer.py\r\n  ```\r\n\r\n2. **Run the Python Script**: Place it in the root folder where you have folders with files you want to rename. Open your terminal, navigate to the folder where you placed `renamer.py`, and execute the script using Python 3:\r\n\r\n  ```sh\r\n  python renamer.py\r\n  ```\r\nAlternatively, if you're using Windows, you can execute the script by double-clicking on it.\r\n\r\n3. **Follow the Prompts**: The Python script will guide you through the renaming process, providing instructions and asking for user input when necessary.\r\n4. **Enjoy the Renamed ePub Files**: Sit back and enjoy your organized digital book collection!\r\n\r\n⚠️ **Note**: the Python script offers the same functionality as the Bash script but may be more convenient for users comfortable with Python programming.\r\n## Folder Structure\r\n\r\nThis structure represents how your existing folder structure should be organized for the script to work:\r\n\r\n```sh\r\n- My ePubs/\r\n  - Light Novel Series/\r\n    - Some Title v01.epub\r\n    - Some Title v02.epub\r\n    - Some Title v03.epub\r\n\r\n  - Another Light Novel/\r\n    - Some Title v01.epub\r\n    - Some Title v02.epub\r\n    - Some Title v03.epub\r\n\r\n  - Random Folder/\r\n    - Random File.epub\r\n```\r\n\r\nThis structure represents how the script works, based on the structure above:\r\n\r\n```sh\r\n- My ePubs/\r\n  - Light Novel Series/\r\n    - Light Novel Series v01.epub\r\n    - Light Novel Series v02.epub\r\n    - Light Novel Series v03.epub\r\n\r\n  - Another Light Novel/\r\n    - Another Light Novel v01.epub\r\n    - Another Light Novel v02.epub\r\n    - Another Light Novel v03.epub\r\n\r\n  - Random Folder/\r\n    - Random File.epub # script will ask what to do with this file\r\n```\r\n\r\n## Tested on Ubuntu and Windows 11\r\n\r\nPlease note that this script has been tested on Ubuntu and Windows 11 systems. While it's likely to work on other Linux and Windows distributions, results on other operating systems may vary.\r\n\r\n## Join the Fun\r\n\r\nWe're all ears! If you spot something funky or have ideas for making this script even cooler, share it with us via [issues](https://github.com/Decaded/epub-renamer/issues).\r\n\r\n## License\r\n\r\nThis script is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecaded%2Fepub-renamer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecaded%2Fepub-renamer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecaded%2Fepub-renamer/lists"}