Skip to main content

me-mover

Me-mover is an application for organizing movies and tv-shows.

TV shows will be moved to [tv-show destination directory]/[show name]/[season directory].

Movies will be moved to [movie destination directory]/[movie name directory]

1. Install me-mover

pip

> pip install me-mover

2. Setup for development

> git clone https://github.com/Alecktos/me-mover.git
> cd me-mover

# create and activate virtual environment
> python -m venv venv
> source venv/bin/activate  # On Windows: venv\Scripts\activate

# install project locally for development
> pip install -e .[dev]

Run tests

> python -m unittest discover tests

3. Usage

By-name

Moves a movie or tv-show from a source directory by searching for its name.

> me-mover by-name {name} {source-dir-path} {show-destination-dir-path} {movie-destination-dir-path}

Example

> me-mover by-name "halt and catch fire" sourcedir media/sorted-tv-shows media/movies

If following files exist:
* `sourcedir/Halt.and.Catch.Fire.S02E08.mp4` 
* `sourcedir/Halt.and.Catch.Fire.S02E09.mp4` 

They will be moved to 
* `media/sorted-tv-shows/Halt And Catch Fire/Season 2/Halt.and.Catch.Fire.S02E08.mp4` 
* `media/sorted-tv-shows/Halt And Catch Fire/Season 2/Halt.and.Catch.Fire.S02E09.mp4`

By-path

Moves a movie or tv-show by its path.

> me-mover by-path {source-path} {show-destination-dir-path} {movie-destination-path}

Example

> me-mover by-path sourcefolder/Star.Wars.The.Clone.Wars.BluRay.1080p.x264.5.1.mp4 media/sorted-tv-shows media/movies

Movie will be moved to `media/movies/Star.Wars.The.Clone.Wars.BluRay.1080p.x264.5.1/Star.Wars.The.Clone.Wars.BluRay.1080p.x264.5.1.mp4`

> me-mover by-path sourcefolder/Vikings.S04E15.720p.mkv media/sorted-tv-shows media/movies

Episode will be moved to `media/sorted-tv-shows/Vikings/Season 4/Vikings.S04E15.720p.mkv`

Watch

Watches a directory and moves new files that are placed in it. Assuming that it's either a movie or tv-show.

> me-mover watch {source-dir-path} {show-destination-path} {movie-destination-path}

Example

> me-mover watch media/inbox media/sorted-tv-shows media/movies

When moving Vikings.S04E15.720p.mkv to media/inbox
It will be moved to media/sorted-tv-shows/Vikings/Season 4/Vikings.S04E15.720p.m

Commands

by-name                Moves all found episodes of specified tv-show. If matching movie all movies matching that name will be moved
  positional arguments:
    name                name of TV show or movie to move
    source              source directory to look for media in
    shows-destination   show destination directory
    movies-destination  movie destination directory

by-path                Moves a movie or tv-show episode.
  positional arguments:
    source              source path of movie or TV show to move
    shows-destination   show destination directory
    movies-destination  movie destination directory

watch                  Monitors changes in a specific directory.
  positional arguments:
    source                source directory to to watch for incoming TV shows and movies
    shows-destination     show destination directory
    movies-destination    movie destination directory
  optional arguments:
    --quit QUIT, -q QUIT  Number of seconds until exit

Subtitles

Subtitles of types .srt, .smi, .ssa, .ass, .vtt will be renamed to the name of the video being moved.

Misc

A parent directory will be created for each moved movie.

If the show name or season directory does not exist they will be created.

Requirements

Python 3.14

watchdog

Metadata

Release files for me-mover 3.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for me-mover 3.2.4
File Size Uploaded Provenance Actions
me_mover-3.2.4.tar.gz 25.0 kB Without provenance Details for me_mover-3.2.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for me-mover 3.2.4
File Interpreter ABI Platform Actions
me_mover-3.2.4-py3-none-any.whl Python 3 none any Details for me_mover-3.2.4-py3-none-any.whl

Total release size: 43.4 kB

Release files / me_mover-3.2.4.tar.gz

Download URL me_mover-3.2.4.tar.gz
Size 25.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e478616b292a3199ba5391992b49793dce1efc4f21c6bb881b82e5856904f118
BLAKE2b-256 checksum
How to use checksums
10def36c57b80e8b0a5b85e6156ca3762ef4e51a5d4722e0b301aafdfdabbb0b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / me_mover-3.2.4-py3-none-any.whl

Download URL me_mover-3.2.4-py3-none-any.whl
Size 18.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7224876a0c4fe004e4afbde6ef26045294ee0239e3b4346c7efa236fe1ecfe77
BLAKE2b-256 checksum
How to use checksums
e5fbe626d01b46517caed4e9343676f2ba6925c3e506a1138271771984f97577
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for me-mover 3.2.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page