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


Play Grateful Dead shows in your terminal.


# Download
git clone /usr/local/src/gdead
# "Build"
ln -s /usr/local/src/gdead/gdead /usr/local/bin/gdead


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 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


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


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


gdead - Stream Grateful Dead soundboards from
Copyright © 2021-2022 Keith Irwin

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