Play grateful dead shows from archive.org
Go to file
Keith Irwin dbe331c644
Better error messages
2024-04-16 10:44:54 -06:00
LICENSE.md Replaced (C) with © 2021-07-05 20:18:55 -06:00
README.md Added --gui flag 2022-07-10 10:29:34 -06:00
gdead Better error messages 2024-04-16 10:44:54 -06:00

README.md

gdead

Play Grateful Dead shows in your terminal.

Installation

# Download
git clone https://gitea.gf4.pw/ki9/gdead.git /usr/local/src/gdead
# "Build"
ln -s /usr/local/src/gdead/gdead /usr/local/bin/gdead

Usage

gdead [-g|--gui] [-r|--rand|--random] [-a|--aud|--audience] [year [month [day]]]

Takes year, month, and day as arguments and plays the top-rated soundboard on archive.org. Providing no unnamed parameters searches the entire vault.

NOTE: The date parsing is still pretty primitive so don't be an edge case: use 4-digit years and 2-digit months/days.

GUI or terminal

By default gdead will open your show with nvlc, which uses an ncurses-based terminal interface. To open the show as a playlist in vlc's GUI, use the -g flag.

Audience recordings

By default, gdead only returns soundboards and matrices. To use audience-recordings too, use the -a flag

Random

To sort by random instead of rating, use the -r flag.

Examples

Play the top-rated version of Woodstock Festival, including audience-tapes:

gdead -a 1969 08 16

Play a random show from '72:

gdead -r 1972

License

gdead - Stream Grateful Dead soundboards from archive.org
Copyright © 2021-2022 Keith Irwin www.ki9.us

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.