Skip to content

Web scrapes the rating of an audiobook, adds it as an ID3-Tag and writes an overview to an excel sheet

Notifications You must be signed in to change notification settings

fabianjuelich/Rateable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rateable

Icon

Rateable is a multiplatform desktop application that allows users to scrape and collect rating data from Audible for any audiobook files (Provided that the folder names used as keywords are chosen wisely). The collected data can be stored in an Excel file and as ID3-tag.

In this way, Rateable provides a convenient way to organize and analyze audiobook ratings and other information to help you decide which book to listen to next.

Features

  • Ratings: Scrapes rating data for each audiobook based on the folder name from Audible (The remaining time is calculated and displayed).
  • Metadata: Fetches audiobook metadata for enhanced information (Choose from ID3 or Audible information).
  • ID3-tag Updates (ToDo): Writes rating stars (and other metadata if not already available) to the audiobook file ID3-tag.
  • Rating Updates: Refresh ratings for previous audiobooks to keep them up to date.
  • Permanent Storage: Stores collected rating data permanently in a database and also saves it to an Excel sheet.
  • Batch Selection: Batch processing for folders containing multiple audiobooks (Recursive search).

Installation

  1. Clone the repository to your local machine.
  2. Install the required dependencies with pip install -r requirements.txt.
  3. Follow the instructions to download the Chromium browser and its driver for your os and place them in the assets folder (possibly you have to edit associated paths in the constructor).
  4. Optional: Customize the TLD used for scraping the Audible website.
  5. Run the app using python main.py (optionally package to make it executable).

Usage

  1. Launch the Rateable application.
  2. Click "Open Explorer" to select the folder containing the audiobook files.
  3. Decide which source to use for metadata retrieval
  4. Confirm the selection, and the application will start scraping the rating data for each audiobook.
  5. If using the application for the first time, specify the save path for the Excel file.
  6. Open the Excel file by clicking "Open result".
  7. To update ratings for previous audiobooks, click "Update".

Screenshots

start-screen result

Credits

Contributing

Contributions are welcome! Please create a new issue or submit a pull request for any issues or suggestions for improvements.

About

Web scrapes the rating of an audiobook, adds it as an ID3-Tag and writes an overview to an excel sheet

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages