johnsturgeon/plex-tools

Utilities and scripts for plex using the Plex API

plex-tools's Issues

Feature Request: Sync ratings to and from Plex Database to IDv3 tags

I'm currently going through the process of tagging my ~10k track library but am worried as I know my plex library may not last forever. Ten years is a good run for many software applications.

Any way - it would be awesome to have the ability to sync track ratings from the plex database into mp3 IDv3 rating tag. I've seen some discussion regarding exacltly which tag ratings are stored in, as it can differ between media library applications such as MediaMonkey / MusicBee / AIMP. Perhaps the rating field could be user-definible to make this feature more adaptable.

According to id3.org the rating tag is the "Popularimeter" field - https://id3.org/id3v2.3.0.

Write 'Wrapper' for Serialized Shazam result

Write prompt for updating metadata

Prompt user for name of playlist containing songs they wish to verify

Probably want to warn the user here that there might be a rate limit on the API calls. I'm probably going to provide an extra warning if the playlist exceeds 100

Configure 'community health' documents for this repo

https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file

Add AcoustID fingerprinting for double checking result

So it seems that Shazam API is not great. The first album I threw at it was "Acoustic Alchemy" "Against the Grain" and unfortunately it mis-matched several songs opting instead for the version where they were performing with an orchestra.

I think as a fallback, we could try acoustID (or maybe even the other way around). The downside is that this will require the user to install "Chromaprint"

Another option is SoundHound, but this would require registration for an API key.

Neither option is great.

Move wrapper classes to 'model' package

Create PyPi package for these tools

I need to package all this up and add it to PyPi

Add 'bit rate' to compare window for Deduplex

Refactor `deduplex.py` `main()` so that it no longer exits, and that it just 'returns'

Make a method that can compare the Shazam track to the JHSTrack

• #35

    def mapped_filepath(self, path_map: Dict[str, str]) -> str:
        """
        Replaces the remote root of the file with the local root given
        Args:
            path_map: Dictionary in the form of
               {
                  remote_root1: local_root1,
                  remote_root2: local_root2,
                  ...
               }

        Returns:
            the full local path the current track
        """
        new_path: str = self.filepath
        for key, value in path_map.items():
            if key in self.filepath:
                new_path = self.filepath.replace(key, value)
        return new_path

Remove unused methods

    def is_duplicate(self, other):
        return self.hash_val == other.hash_val

    def is_identical(self, other):
        return self.track == other.track

Along with property
self.hash_val = str(f"{self.title}{self.artist}{self.album}{self.duration}")

Deprecate method `console_log`

[Feature request] Option to add automatic sorting based on bitrate

Issue: I have a library with over 120 000 songs, and I ran this program, and there are 1034 duplicates found. There seems to be no option to just automatically go through the songs. It's unfortunately unusable for that reason.

Proposed solution: Add a feature, which asks the user if they want to use an automatic process, which uses few different methods for sorting. Some that came into my mind:

1. Creation date: delete either the older or the newer duplicates
2. Size: Delete either the larger one or smaller one
3. Bitrate: Delete either the one with higher bitrate or the one with lower
4. Album or single: If the track has album and single versions, select which one to prefer
5. Regex recognition: for example if the track name has (1) in it, you could use regex to detect that

Those options could be merged so let's say "I want the songs where creation date does not matter, but if the track is bigger, and has larger bit rate and has (1) in the file name, delete it right away"

Justification: Better user experience for users with a tad larger libraries. Also helps users to gain more power over which versions they want to keep and which to delete.

Clean up flake8 error (method too complex C901) in `main` of `deduplex.py`

I've disabled it for now to get the linter passing, but I really need to refactor that in the next major overhaul

Move from poetry to more common 'pip' with virtualenv

Write authentication in a modular way

I'm going to use the same authentication .env workflow as the other scripts, so it only makes sense to write it so that the other script can eventually just include it.

Add 'flake8' linting

Write unit tests for the deduplex file

I got some unit tests in, but it would be nice to finish them and cover deduplex as well.

fix pylint "Too Many Branches" / "Too Many Statement" for `deduplex.py` `main()`

Create release with downloadable executables for different OS'

Looking into pyinstaller for that

Add pylint to CI workflow

[Feature Request] Add the ability to choose your music library

The issue was raised here #14. Many users have multiple libraries, and instead of putting it into your .env, you can choose at run time a list of libraries to go through.

Write unit tests

Now that it looks like there will be some contributors, I think it's time to start to write some unit tests.

Loop through files and pull metadata from Shazam

Run pylint on project

Add back filepath code

Prompt for root folder mapping

Many times this won't be run on the same machine as a remote Plex server, therefore we need to create a 'map' to the root of the library folder with a folder that's accessible to the script.

Figure out how to move file after metadata has been fixed

Draw up some guidelines for contributions

Getting some contributors is critical to the code's survival, but I need to make sure there are some reasonable guidelines for contributors.