/_FUN_Emaner

A user-friendly macOS tool for efficient and customizable file renaming, supporting bulk operations and advanced patterns with regular expressions.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Emaner

Batch rename your files as per your will.
Explore the docs »

· Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Usage
  3. Contributing
  4. License
  5. Contact

About The Project

Logo

Emaner is a dynamic and user-friendly file renaming application designed to facilitate quick and efficient organization of your digital files. Developed in Python and utilizing the tkinter framework for its graphical user interface, Emaner stands out for its intuitive design and versatile functionality.


Key Features:
  1. Customizable File Renaming: Allows users to rename files in bulk according to specific patterns or criteria.
  2. Regular Expression Support: Advanced users can utilize regular expressions for complex renaming patterns, making it ideal for large datasets.
  3. User-Friendly Interface: Designed with a clean and easy-to-navigate GUI, ensuring accessibility for users of all skill levels.
  4. Extension-Specific Renaming: Users can target specific file extensions, providing greater control over the renaming process.
  5. Preview Capability: Before finalizing changes, users can preview the new file names, ensuring accuracy and satisfaction with the results.
  6. Platform Independence: Being a Python-based application, it can be run on any platform that supports Python and tkinter.


Emaner is particularly suited for professionals who manage large collections of files, such as photographers, digital librarians, and data analysts, as well as for personal use in organizing documents, images, and multimedia files.

(back to top)

Built With

Icon   Icon

(back to top)

Usage


Feature Description
Select Folder Display files present in the selected folder
Include Subfolders Display files present in every subfolders
Regular Expression Activate the RE naming - The Replace field will accept RE sequences
? Display the most used RE sequences in a separate window as example
Preserve Extension Prevent the extensions file to be changed
Rename Files Execute the renaming
"Combobox" Sort out files by extensions (down right of the window)
  1. Starting the Application: Simply run the emaner.py script in a Python environment where tkinter is installed.
  2. Selecting Files: Use the 'Select Folder' button to choose the directory containing the files you wish to rename.
  3. Setting Renaming Criteria:
  4. Basic Renaming: Enter the desired new name for the files.
  5. Using Regular Expressions: For advanced renaming, activate the regular expression option and enter the appropriate pattern.
  6. Choosing File Extensions: If you want to rename files of a specific type, select the desired extension from the dropdown menu.
  7. Preview Renames: Before applying changes, you can preview the new file names to ensure they match your expectations.
  8. Applying Changes: Once satisfied with the preview, click on 'Rename Files' to apply the changes.

Note: Emaner also supports subfolder inclusion and preservation of file extensions during renaming, providing additional flexibility. Detailed instructions and tips for using regular expressions are provided within the application for users unfamiliar with this powerful tool.

Standalone APP

Install pyintaller

pip install pyinstaller

Generate the standalone app

pyinstaller --onefile your_script_name.py

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GNU GENERAL PUBLIC LICENSE. See LICENSE.txt for more information.

(back to top)

Contact

LinkedIn

(back to top)