Media File Renamer

Open source media file renamer, built with Electron, React, & Python. Easily rename digital copies of your favorite titles, in bulk. Keeping the names accurate, and making them easier to import to media libraries such as Plex and/or Kodi.

media_file_renamer

💾 Downloads

Media File Renamer works on Windows 32-bit (x86) and Windows 64-bit (x64) operating systems, see the project's releases page for download links.

🛠️ Setup

To build and run locally (e.g., for developing), ensure you have Node and Python installed, then clone this repository. After it's cloned, navigate to the project's root directory on your computer and run the following scripts in a terminal application (e.g., Git Bash):

Python dependencies:

pip3 install -r requirements.txt

Node dependencies:

yarn install

📜 Scripts

in order to start electron, you must first build React & Python:

Build Documentation:

yarn run build:docs

Build React & Python:

yarn run build:all

Build React:

yarn run build:react

Build Python:

yarn run build:python

Start Electron:

yarn run start

📦 Packaging

Build Windows:

yarn run build:package:windows

Build MacOS:

yarn run build:package:mac

🙏 Attribution

TV information is provided by the TVmaze API
SVG icons used are from Font Awesome

🐱‍👓 Docs

Code documentation for this project, created with JSDoc, can be found here:
Media File Renamer

🦟 Software bugs

Bugs reported on the project's issues page will be exterminated as quickly as possible, be sure to include steps to reproduce so they can be spotted easily.