Books Renamer is a Ruby script that automates the renaming of PDF files within a specified directory based on metadata extracted from each file. It uses the title and author information from the PDF metadata to construct new, more descriptive filenames. The script can operate in a dry run mode to display what changes it would make without actually renaming any files.
- Extracts metadata (title and author) from PDF files.
- Renames PDF files based on extracted metadata.
- Supports dry run mode to preview potential changes without modifying files.
- Uses I18n for transliteration to handle non-ASCII characters in filenames.
To run Books Renamer, you'll need Ruby installed on your machine. You will also need to install several dependencies:
bundle installTo use Books Renamer, navigate to the directory containing your script and run:
./bin/rename_books DIRECTORY [--update]Options:
DIRECTORY: The path to the directory containing the PDF files you want to rename.--update: Optional flag to apply the renaming changes. Without this flag, the script will only perform a dry run.
Using the --update flag will permanently replace the file names in the specified directory. Make sure to back up your files or use the dry run mode to review changes before applying this flag.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
To contribute to Books Renamer, follow these steps:
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a pull request
Copyright (c) 2024 Martin Ferrari dmferrari@gmail.com
This software is provided 'as is', without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
Distributed under the MIT License.
This project uses several key open-source libraries:
- PDF-Reader: Essential for extracting PDF metadata.
- I18n: Handles filename transliteration for better filesystem compatibility.
- RSpec: Provides a framework for behavior-driven development testing.
- Byebug: A debugger for stepping through code and inspecting states.
- RuboCop: Ensures code quality and adherence to Ruby style guidelines.
Thanks to these tools and their contributors for supporting the development of Books Renamer.