MediaMover

A tool for organizing your media files.

Report Bug · Request Feature

:notebook_with_decorative_cover: Table of Contents

• About the Project
  • Screenshots
  • Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
  • Code of Conduct
• License
• Contact
• Acknowledgements

:star2: About the Project

:camera: Screenshots

:dart: Features

• Identifies and organizes TV Show files by show and season.
• Identifies and organizes Movie files by genre.

:toolbox: Getting Started

:bangbang: Prerequisites

You must have a valid API key for TMDB. To register for a free API key, click the API link from within your account settings page.

:gear: Installation

Download the binary from our Releases Page.

We'll have better installation options in the future.

:eyes: Usage

After installing create a config.ini file in the same folder where you placed mediamover using the following format:

api_key = <YOUR_TMDB_API_KEY>
tv_root = <The Path to Store Your TV Show Files>
movie_root = <The Path to Store Your Movie Files>

For example,

api_key    = abcdef123456abcdef123456
tv_root    = ~/Videos/TVShows/
movie_root = ~/Videos/Movies/ 

After that's created and the values are set properly, you can load your movies or shows.

:tv: TV Shows

$ mediamover -v tvshows ~/Downloads/TVShows
Wrote ~/Videos/TV/Only Murders in the Building/Season 04/Only Murders in the Building S04E04.mkv
Wrote ~/Videos/TV/Only Murders in the Building/Season 04/Only Murders in the Building S04E05.mkv
Wrote ~/Videos/TV/SEAL Team/Season 07/SEAL Team S07E05.mkv
Unable to write file ~/Videos/TV/The Rookie/Season 06/The Rookie S06E07.mkv: "~/Videos/TV/The Rookie/Season 06/The Rookie S06E07.mkv already exists"

:movie_camera: Movies

$ mediamover -v movies ~/Downloads/Movies
Wrote ~/Videos/Movies/Action/The Killers Game (2024).mkv
Wrote ~/Videos/Movies/Comedy/The Radleys (2024).mkv
Wrote ~/Videos/Movies/Horror/Opera (1987).mkv

:compass: Roadmap

• [ ] User-configurable organization (#2)

:wave: Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

:scroll: Code of Conduct

We don't have one yet, but that'll change. For now, be good humans.

:warning: License

Distributed under the Apache 2.0 License. See LICENSE for more information.

:handshake: Contact

Sean Callaway - @seancallaway - seancallaway@gmail.com

Project Link: https://github.com/seancallaway/mediamover

:gem: Acknowledgements

mediamover wouldn't be possible without the following packages:

• regexp2
• Cobra
• Viper

Genre lookups for movies are made using

<img src="https://www.themoviedb.org/assets/2/v4/logos/v2/blue_square_1-5bdc75aaebeb75dc7ae79426ddd9be3b2be1e342510f8202baf6bffa71d7f5c4.svg" width="200" />