README.md

Join Slack

Add Cover Art

If you are bored of looking at a lame cover photo while browsing through your songs which doesn't even matches the song or it is the logo of the website from where you have downloaded that mp3 file.

This application will find all the .mp3 file in your computer and automatically scrape a suitable cover from google images and apply it to the mp3 file.

Getting Started

These instructions will help you run this application in your local machine.

Prerequisites

As the script is written in python, you need to download Python on your system, specifically Python 3.x or latest. Its installer can be downloaded from here. Linux Users: Open Terminal and type

sudo apt-get install python3.6

Installing Packages

1. Fork this repository and then clone the repository to your local system using git clone or extract the downloaded zip file.

---

2. Run requirements.txt on command prompt/shell using pip

  pip install -r requirements.txt

3. Install the following modules using pip (Optional)

  pip install python-magic-bin

if error related to image or ImageTk still persists, run the following commands:

  pip install image

For Linux systems, run the given command on shell:

  sudo apt-get install python3-pil.imagetk

Creating Virtual Environment (optional)

To activate this project's virtualenv, run pipenv shell. Alternatively, run a command inside the virtualenv with pipenv run.

Usage and Deployment

usage: main.py [-h] [--silent] [--no-gui | --overwrite] [path]

Add Cover Art: This application will find the .mp3 files in your computer.
Then it will automatically scrape a suitable cover from google images and
apply it as a cover art to the mp3 file.

positional arguments:
  path         file or directory to be processed (default: current directory)

optional arguments:
  -h, --help   show this help message and exit
  --silent     don't show console output
  --no-gui     don't use a gui and overwrite current cover art from a list of choices
  --overwrite  use gui and overwrite current cover art from a list of choices

if no optional argument is specified, the gui is enabled and overwrite is
disabled

Note:

• not including --overwrite argument adds the current cover art (if present) at the start of the chain of available images.
• --no-gui argument doesn't display gui and adds the first available image as cover art

Usage:

1. Run command prompt or linux shell
2. Change directory into the directory containing the .mp3 files
3. Run the script
4. Press the ⇦ and ⇨ keys to browse an image that you may like.
5. Press Apply Button to set the image as the cover photo if you like it.
6. Press Next Button to process another .mp3 file
7. Press Cancel Button to close the application.
8. If you are unhappy with the images suggested, enter your own query into the search box and press Search

Sample