From f24f9223c6eba87c91b03ba40e2bd240a0d6426c Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 18:34:54 -0500 Subject: [PATCH 1/6] Update README.md --- README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5df518f..37da931 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -# odm-plex -Automates the process of opening ODM's and formatting them for use in Plex including editing down to chapters and adding metadata on Mac OS. +# overdrive-plex +Automates the process of opening Overdrive .odm files and formatting them for use in Plex including editing down to chapters and adding metadata on Mac OS. See the end of this readme for a long list of credits as this code is based on many pre-existing projects and scripts and would fully not be possible without them. @@ -51,4 +51,3 @@ Thanks to: chbrown for creating and maintaining https://github.com/chbrown/overdrive ex-nerd for the wonderful code "extract_overdrive_chapters.py" seanap for the Plex Audiobook Guide -jw3134 for the support and guidance From 500c2c749cfc4fd57220b4cf804c5a9006cffca4 Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 18:35:50 -0500 Subject: [PATCH 2/6] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 37da931..0ce26f8 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ -# overdrive-plex +# Overdrive to Plex + Automates the process of opening Overdrive .odm files and formatting them for use in Plex including editing down to chapters and adding metadata on Mac OS. See the end of this readme for a long list of credits as this code is based on many pre-existing projects and scripts and would fully not be possible without them. From 770e68cf0e238397c0e87766b9413da235786fe4 Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 18:37:24 -0500 Subject: [PATCH 3/6] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0ce26f8..c2140f7 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ The order of operations for the whole process is as follows: vii) Add metadata to the chapterized mp3's including track numbers and any simple metadata provided by Overdrive and move them to the bookshelf 3) Optional but Recommended: Use seanap's audible sources for mp3tag to correct and expand metadata for each book. I say optional because if your goal here is to just extract chapterized versions of the odm mp3's and start listening this isn't necessary. But for anyone like me who get's a bit picky about the way their library is formatted going the extra mile to addend all the proper metadata here is key. Another issue that arises with the original process is that Overdrive's metadata files are heavily lacking in details. As a result it's often the case that narrator names get messed up etc. If you care about precision this extra step is key. -4) Add to your server +4) Add to your collection You can find a lot of great advice and detailed walk-throughs on how to setup Plex libaries with audiobook functionality here: https://github.com/seanap/Plex-Audiobook-Guide From aebd76aa03f4129ef0d3df4a81b4902d830379f5 Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 19:07:17 -0500 Subject: [PATCH 4/6] Update README.md --- README.md | 81 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 51 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index c2140f7..07a0c44 100644 --- a/README.md +++ b/README.md @@ -1,54 +1,75 @@ # Overdrive to Plex -Automates the process of opening Overdrive .odm files and formatting them for use in Plex including editing down to chapters and adding metadata on Mac OS. +### Automates the process of opening Overdrive .odm files and formatting them for use in Plex including editing down to chapters and adding metadata on Mac OS. See the end of this readme for a long list of credits as this code is based on many pre-existing projects and scripts and would fully not be possible without them. +## Overview The simple goal here is to make the process of unpacking and editing .odm files a lot simpler. The issue I have run into is that Overdrive provides mp3 files split up into parts, but those parts don't align with chapters and the only real solution I've found out there is to use Audacity to manually label each chapter. I did that for a while and it sucked so I learned what I needed to learn to scrape this together. Unfortunately, this does not take all manual labor out of the process as I am not skilled enough to make that leap. Important manual steps in this process are 1) Downloading the .odm files from overdrive, and 2) Adding them to wherever it is you want to access them whether it be a server, etc. -I will note that I am not an expert. I taught myself how to use python and bash in order to try and automate a process that I was getting frustrated by. With that being said I welcome anyone who has stumbled across this to take it and improve it for themselves. I also apologize to anyone using this who gets exasperated by any stupid mistakes or redundant processes I created along the way. If there were better solutions out there I would have used them instead of making this but as it stands now I couldn't find anything out there that automated the process to this extent so, for now, we all have to deal. +I will note that **I am not an expert**. I taught myself how to use python and bash in order to try and automate a process that I was getting frustrated by. With that being said I welcome anyone who has stumbled across this to take it and improve it for themselves. I also apologize to anyone using this who gets exasperated by any stupid mistakes or redundant processes I created along the way. If there were better solutions out there I would have used them instead of making this but as it stands now I couldn't find anything out there that automated the process to this extent so, for now, we all have to deal. -Note: This code assumes you have installed the following: +### This code assumes you have installed the following: -chbrown/overdrive -python3.10 -pydub -ffmpeg -mutagen +- **[chbrown/overdrive](https://github.com/chbrown/overdrive)** +- **python3.10** +- **pydub** +- **ffmpeg** +- **mutagen** You can reference https://github.com/chbrown/overdrive for setup on the chbrown script as well as tips and tricks for all things Overdrive. +## Organization I've organized my directory into the following folder structures mainly because I find it easier to follow the process when I'm visualizing the steps, but it should go without saying that you can mix and match this to your liking. -BOOKS - 00_ARCHIVE - 01_ANNEX - 02_CIRCULATION - 03_BOOKSHELF +- BOOKS + - 00_ARCHIVE + - 01_ANNEX + - 02_CIRCULATION + - 03_BOOKSHELF + +## Setup +### Config -The order of operations for the whole process is as follows: -1) Download ODM's -2) Run overdrive_full.sh - i) Unpack odm's & add to annex along with metadata file - ii) Extract list of chapters - iii) Format metadata into xml - iv) Convert chapter start times to ms - v) Create final labels file showing chapter durations - vi) Import mp3's end to end and export chapterized versions to circulation using labels file - vii) Add metadata to the chapterized mp3's including track numbers and any simple metadata provided by Overdrive and move them to the bookshelf -3) Optional but Recommended: Use seanap's audible sources for mp3tag to correct and expand metadata for each book. +Make sure that you have edited the config.py and config.env files to accurately reflect your system/folder structures. + +### Calling the Script + +The main bash script assumes that all of the scripts are sitting in the same folder, if that's not the case make sure you adjust the parameters accordingly before running. + +### Note on .odm's + +A known issue with downloading the contents of .odm files is that in some cases certain errors related to the license will occur. In those cases this script will skip the file in question and continue on. The only fix for that is to redownload the odm. + +## Execution +### The order of operations for the whole process is as follows: +1. **Download ODM's** +2. **Run overdrive_full.sh** + 1. Unpack odm's & add to annex along with metadata file + 2. Extract list of chapters + 3. Format metadata into xml + 4. Convert chapter start times to ms + 5. Create final labels file showing chapter durations + 6. Import mp3's end to end and export chapterized versions to circulation using labels file + 7. Add metadata to the chapterized mp3's including track numbers and any simple metadata provided by Overdrive and move them to the bookshelf +3. **Optional but Recommended:** Use [seanap's audible sources](https://github.com/seanap/Plex-Audiobook-Guide) for mp3tag to correct and expand metadata for each book. +
More details +

I say optional because if your goal here is to just extract chapterized versions of the odm mp3's and start listening this isn't necessary. But for anyone like me who get's a bit picky about the way their library is formatted going the extra mile to addend all the proper metadata here is key. Another issue that arises with the original process is that Overdrive's metadata files are heavily lacking in details. As a result it's often the case that narrator names get messed up etc. If you care about precision this extra step is key. -4) Add to your collection +

+
+4. **Add to your collection** You can find a lot of great advice and detailed walk-throughs on how to setup Plex libaries with audiobook functionality here: https://github.com/seanap/Plex-Audiobook-Guide +## Final Note I decided not to involve an automated mb4 script in this because I've found that that process is still a bit manual for me. The reason being that I like packaging mb4's based around parts instead of tossing the full book inside of one or two. It's difficult to figure out a way of automating that given the lack of clear delineation of parts so I'm keep it manual for now. -And lastly all of this was inspired by my discovery of lcharlick's Prologue App (https://prologue.audio/), which, in my opinion, is the best iOS app for all things personal audiobooks collection. This whole process has been built around optimizing my experience using that app in tandem with Plex but it should be malleable to other systems with a little tweaking here and there. +And lastly all of this was inspired by my discovery of the [Prologue App](https://prologue.audio/) by @lcharlick, which, in my opinion, is the best iOS app for all things personal audiobooks collection. This whole process has been built around optimizing my experience using that app in tandem with Plex but it should be malleable to other systems with a little tweaking here and there. -Thanks to: -chbrown for creating and maintaining https://github.com/chbrown/overdrive -ex-nerd for the wonderful code "extract_overdrive_chapters.py" -seanap for the Plex Audiobook Guide +## Thanks to: +- @chbrown for creating and maintaining https://github.com/chbrown/overdrive +- @ex-nerd for the wonderful code "extract_overdrive_chapters.py" +- @seanap for the Plex Audiobook Guide From 8c95b5bedac11c783e92e17b43c554b964e6ff3c Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 19:12:58 -0500 Subject: [PATCH 5/6] Update README.md --- README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 07a0c44..dbf97bd 100644 --- a/README.md +++ b/README.md @@ -7,19 +7,21 @@ See the end of this readme for a long list of credits as this code is based on m ## Overview The simple goal here is to make the process of unpacking and editing .odm files a lot simpler. The issue I have run into is that Overdrive provides mp3 files split up into parts, but those parts don't align with chapters and the only real solution I've found out there is to use Audacity to manually label each chapter. I did that for a while and it sucked so I learned what I needed to learn to scrape this together. -Unfortunately, this does not take all manual labor out of the process as I am not skilled enough to make that leap. Important manual steps in this process are 1) Downloading the .odm files from overdrive, and 2) Adding them to wherever it is you want to access them whether it be a server, etc. +Unfortunately, this does not take all manual labor out of the process as I am not skilled enough to make that leap. Important manual steps in this process are... +1. Downloading the .odm files from overdrive +2. Adding them to wherever it is you want to access them whether it be a server, etc. I will note that **I am not an expert**. I taught myself how to use python and bash in order to try and automate a process that I was getting frustrated by. With that being said I welcome anyone who has stumbled across this to take it and improve it for themselves. I also apologize to anyone using this who gets exasperated by any stupid mistakes or redundant processes I created along the way. If there were better solutions out there I would have used them instead of making this but as it stands now I couldn't find anything out there that automated the process to this extent so, for now, we all have to deal. ### This code assumes you have installed the following: - **[chbrown/overdrive](https://github.com/chbrown/overdrive)** -- **python3.10** -- **pydub** -- **ffmpeg** -- **mutagen** +- **[python3](https://www.python.org/)** +- **[pydub](https://github.com/jiaaro/pydub/)** +- **[ffmpeg](https://github.com/jiaaro/pydub#getting-ffmpeg-set-up)** +- **[mutagen](https://mutagen.readthedocs.io/en/latest/)** -You can reference https://github.com/chbrown/overdrive for setup on the chbrown script as well as tips and tricks for all things Overdrive. +Reference the linked repositories for tips and tricks on setting up each one. ## Organization I've organized my directory into the following folder structures mainly because I find it easier to follow the process when I'm visualizing the steps, but it should go without saying that you can mix and match this to your liking. From 256b2df6f7a76edb4d4087a6dca0a670961ecf13 Mon Sep 17 00:00:00 2001 From: bender <123113548+LeLawnGames@users.noreply.github.com> Date: Wed, 25 Jan 2023 19:31:30 -0500 Subject: [PATCH 6/6] Delete __pycache__ directory --- __pycache__/config.cpython-310.pyc | Bin 512 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 __pycache__/config.cpython-310.pyc diff --git a/__pycache__/config.cpython-310.pyc b/__pycache__/config.cpython-310.pyc deleted file mode 100644 index fdeadfc4d174c56ec4df89d9c14541f5505b1c29..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 512 zcma)&%}&BV5XZM)P%!uso=B8Mj2Aqv5gr?)79Eo_6tmqpM zB{jE|@3TJ+#+*>NWg%ZtL4*R27AalBn6q*6+*rI8c6-iAmeO-gt&{soY_qD|)J?-Q GY~u&|dX$C$