Project

deadlist

0.0
No release in over 3 years
A Ruby gem for downloading Grateful Dead concert recordings from the Internet Archive
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

~> 0.21
~> 1.10
 Project Readme

deadlist

A client for interacting with Grateful Dead recordings hosted by archive.org.

Using Deadlist, you can

  • Download files in any of the formats available, regardless of if they have been marked as "Stream Only".

In the future, you can use Deadlist to

  • Get lists of shows by date or location
  • Get lists of recordings for specific shows, including set lists and information about the upload
  • Get formats a show is available in

Arguments

  • --format (required) | --format=mp3 | Format for track downloads, typically .mp3, .ogg or .flac
  • --link (required) | --link={uri} | Show link from archive.org to get the link from

How Its Structured

Deadlist scrapes audio files from archive.org pages by getting the HTML for the page, identifying .mp3 (or other audio formats) within and retrieving the files.

  • DeadList::Client -- Core scraping logic
  • DeadList::CLI -- Command line interface
  • DeadList::Track -- Data model
  • DeadList::Show -- Data model
  • DeadList::Downloader -- Download orchestration