Skip to content

A tool for organizing your media files.

License

Notifications You must be signed in to change notification settings

seancallaway/mediamover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

MediaMover

A tool for organizing your media files.

contributors last commit open issues license


📔 Table of Contents

🌟 About the Project

📷 Screenshots

Coming soon!

🎯 Features

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

🧰 Getting Started

‼️ 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.

⚙️ Installation

Download the binary from our Releases Page.

We'll have better installation options in the future.

👀 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 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"

🎥 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

🧭 Roadmap

  • User-configurable organization (#2)

👋 Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

📜 Code of Conduct

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

⚠️ License

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

🤝 Contact

Sean Callaway - @seancallaway - [email protected]

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

💎 Acknowledgements

mediamover wouldn't be possible without the following packages:

Genre lookups for movies are made using