Bible-Playlist-Generator

This python script generates an m3u playlist of 10 Bible Chapters (represented by 10 mp3 files) to be listened to on any given day x, according to Professor Grant Horner's Bible-Reading System. The audio Bible is as downloaded from the Faith Comes by Hearing® website.

The script also copies the files on the playlist into a new folder so that you can carry the folder on your USB or any other device and listen anywhere (car, home theatre, phone, tablet, etc).

Usage

From the command prompt,

python bible_playlist_generator.py -d x

where x is an integer that represents the day on the Bible-Reading System, as in day 1, day 2, ... day 524, etc. For example, if you want the playlist for day 37;

python bible_playlist_generator.py -d 37

Help

python bible_playlist_generator.py --help

Prerequisites / Assumptions

• Python must be installed on your computer and added to the PATH (the script has been tested on GNU/Linux and Windows¹ running Python 2.7 3.6 / 3.7. I have since moved to python3. If you are still using python2, you need to switch to python3!).

• Install the dependencies:

pip install -r requirements.txt

• The script requires the following files, which are in the data subdirectory:
  • list_01.txt
  • list_02.txt
  • list_03.txt
  • list_04.txt
  • list_05.txt
  • list_06.txt
  • list_07.txt
  • list_08.txt
  • list_09.txt
  • list_10.txt

These text files contain the Bible Chapters in the lists from Professor Grant Horner's Bible-Reading System.

• In addition to the above, it is assumed that:

  1. the Bible folder is also on the same path as the python script and the above files.
  2. the Bible folder is named ENGESVC2DA by default. If your Bible folder is named differently, pass the folder name as an argument to the script:

  python bible_playlist_generator.py -d 37 -f "Name_of_folder"

Important Notes

• This script will only be useful to you if you use Professor Grant Horner's Bible-Reading System as the basis for your Bible Reading Plan.
• The Audio Bible version used is the 2001 ESV dramatized Bible (complete), as freely downloaded from http://www.bible.is/audiodownloader. (The size is over 2Gb)

Extras

make_one_week_playlist.sh

There's a bash script make_one_week_playlist.sh which allows you to create playlists for a week or whatever period you so wish. I created it because I wanted to make my playlists in advance and copy the files to my other devices and external media only once. Also, I only get to run one command and I have as many playlists as I want!

All you need to do is specify the start day as an argument to the script, as shown below:

$ ./make_one_week_playlist.sh 200

If you want playlists for a period longer than seven days, edit the script and modify the $END variable accordingly.

Tests

Simply run pytest in the root directory of this repository. If you want to check the coverage and get more details of the tests, you could run

pytest -vv --cov=. --cov-report term-missing

TODO

• Address #1. configparser might come in handy here.
• Package this project
• Improve Code Quality
• Rather than using plain text files, find a better way of storing the Bible Chapters (JSON file, SQLite database, TinyDB, etc)
• Create a GUI frontend or web service to cater for non-tech users

---

Footnotes

1: I am yet to test it on a Mac (I expect it to run just fine!). Previous versions of the script ran well on Mac OS X. However, since the major re-write of the script in September 2019, I haven't tested it on other platforms other than Ubuntu and Windows.