{"id":24989049,"url":"https://github.com/engineervix/ten-lists","last_synced_at":"2025-07-13T08:34:30.215Z","repository":{"id":17447296,"uuid":"20221076","full_name":"engineervix/ten-lists","owner":"engineervix","description":"A web application that facilitates listening 👂🎧🔊 to the Holy Bible based on Professor Grant Horner's Bible-Reading System.","archived":false,"fork":false,"pushed_at":"2025-06-18T00:26:26.000Z","size":2528,"stargazers_count":4,"open_issues_count":19,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-18T01:30:32.267Z","etag":null,"topics":["alpinejs","bible-chapters","bible-playlist-generator","bible-reading","plyr","vite"],"latest_commit_sha":null,"homepage":"https://ten-lists.pages.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/engineervix.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-05-27T13:34:36.000Z","updated_at":"2025-05-10T09:40:34.000Z","dependencies_parsed_at":"2024-02-10T22:22:41.308Z","dependency_job_id":"f1d9f5c9-27d2-474f-a62b-06cdceba87a7","html_url":"https://github.com/engineervix/ten-lists","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/engineervix/ten-lists","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Ften-lists","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Ften-lists/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Ften-lists/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Ften-lists/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/engineervix","download_url":"https://codeload.github.com/engineervix/ten-lists/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engineervix%2Ften-lists/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260852154,"owners_count":23072603,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alpinejs","bible-chapters","bible-playlist-generator","bible-reading","plyr","vite"],"created_at":"2025-02-04T12:14:29.619Z","updated_at":"2025-06-20T00:07:42.062Z","avatar_url":"https://github.com/engineervix.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ten-lists\n\nA web application that facilitates listening 👂🎧🔊 to the Holy Bible based on [Professor Grant Horner's Bible-Reading System](https://sohmer.net/media/professor_grant_horners_bible_reading_system.pdf).\n\n\u003cdetails\u003e\n  \u003csummary\u003e📱 Screenshot - Mobile\u003c/summary\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/4f05409a-5ff3-4a70-ab72-4eda9df57d20\" alt=\"mobile\"\u003e\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e🖥️ Screenshot - Desktop\u003c/summary\u003e\n\n![desktop](https://github.com/user-attachments/assets/85d38838-2b04-4dcc-afed-95320cc2b5f1)\n\n\u003c/details\u003e\n\n[![Continuous Integration](https://github.com/engineervix/ten-lists/actions/workflows/main.yml/badge.svg)](https://github.com/engineervix/ten-lists/actions/workflows/main.yml)\n[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/engineervix/b8c0c76feb9db65c08ca3190cc90e46a/raw/covbadge.json)](https://github.com/engineervix/ten-lists/actions)\n\n[![Node v22](https://img.shields.io/badge/Node-v22-teal.svg)](https://nodejs.org/en/blog/release/v22.0.0)\n[![code style: prettier](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://prettier.io/)\n\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)\n[![Conventional Changelog](https://img.shields.io/badge/changelog-conventional-brightgreen.svg)](https://github.com/conventional-changelog)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Features](#features)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Deployment](#deployment)\n  - [Setting Up Your Cloud Storage](#setting-up-your-cloud-storage)\n    - [Common Cloud Storage Options](#common-cloud-storage-options)\n      - [Cloudflare R2](#cloudflare-r2)\n      - [Backblaze B2](#backblaze-b2)\n      - [AWS S3](#aws-s3)\n  - [Cloudflare Pages](#cloudflare-pages)\n  - [Other Platforms](#other-platforms)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Features\n\n- Generate a playlist of 10 Bible chapters for any day in the bible reading plan.\n- Audio playback of Bible chapters using [Plyr.io](https://plyr.io/)\n- Responsive design with [tailwindcss](https://tailwindcss.com/)\n- Interactive UI with [Alpine.js](https://alpinejs.dev/)\n- Bible reference tooltips via [Blue Letter Bible ScriptTagger](https://www.blueletterbible.org/webtools/BLB_ScriptTagger.cfm)\n- [`localStorage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage) to remember your current reading day\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (v22 or higher)\n- npm\n\n### Installation\n\n1. Clone the repository:\n\n   ```sh\n   git clone https://github.com/engineervix/ten-lists.git\n   cd ten-lists\n   ```\n\n2. Install dependencies:\n\n   ```\n   npm install\n   ```\n\n3. Set up audio files:\n\n   - During development, audio files should be placed in a `/public/audio` directory\n   - The audio files should follow this naming convention:\n     - Old Testament: `A[book-code]___[chapter]_[formatted-name]ENGESVC2DA.mp3`\n     - New Testament: `B[book-code]___[chapter]_[formatted-name]ENGESVC2DA.mp3`\n\n   For example:\n\n   - Job 1: `A18___01_Job_________ENGESVC2DA.mp3`\n   - Song of Solomon 8: `A22___08_SongofSongs_ENGESVC2DA.mp3`\n   - Acts 1: `B05___01_Acts________ENGESVC2DA.mp3`\n\n   That's the convention used for the ESV dramatized audio Bible downloaded from the [_Faith Comes by Hearing®_ website](http://www.bible.is/audiodownloader).\n\n4. Start the development server:\n\n   ```\n   npm run dev\n   ```\n\n5. Build for production:\n   ```\n   npm run build\n   ```\n\n## Deployment\n\nYou'll need the audio files to be hosted on cloud storage, e.g.\n\n- Cloudflare R2\n- Backblaze B2\n- AWS S3\n\n### Setting Up Your Cloud Storage\n\n1. Create a bucket/container in your preferred cloud storage service.\n2. Configure public access for the bucket (if you want files to be directly accessible).\n3. Upload all audio files to the bucket.\n4. Note your bucket URL.\n5. Set up appropriate CORS settings.\n\n#### Common Cloud Storage Options\n\n##### Cloudflare R2\n\nYour URL will typically be: `https://{account-id}.r2.cloudflarestorage.com/{bucket-name}`\n\n##### Backblaze B2\n\nYour URL will typically be: `https://{bucket-name}.s3.{region}.backblazeb2.com`\n\n##### AWS S3\n\nYour URL will typically be: `https://{bucket-name}.s3.amazonaws.com`\n\n### Cloudflare Pages\n\nThis application can be deployed to Cloudflare Pages:\n\n1. Connect your GitHub repository to Cloudflare Pages.\n2. Configure the `VITE_MP3_BASE_URL` environment variable in the Cloudflare Pages dashboard.\n3. Set the build command to `npm run build` and the build directory to `dist`.\n\n### Other Platforms\n\nYou should be able to deploy to Github Pages, Gitlab Pages, Vercel, Netlify, and many other platforms. Check the respective platform docs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Ften-lists","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengineervix%2Ften-lists","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineervix%2Ften-lists/lists"}