Static site generator for making web mixtapes in 2020.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Matt Baer e64dae9c2d Use consistent indentation in templates 1 year ago
cmd/cdr Don't log errors for .tmpl files when parsing audio files 1 year ago
templates Use consistent indentation in templates 1 year ago
LICENSE Add LICENSE 3 years ago Explain template options in README 1 year ago
go.mod Use Go's embed pkg instead of inline tool 1 year ago
mixtape.tmpl Use consistent indentation in templates 1 year ago
render.go Remove superfluous embed import in render.go 1 year ago
sanitize.go Clean filenames without track numbers 1 year ago
templates.go Use Go's embed pkg instead of inline tool 1 year ago
track.go Add Num field to Track 3 years ago

CD-R 700mb

Before Spotify, Apple Music, Amazon Music Unlimited, Amazon Music HD, Google Play Music, Tidal, Deezer, Pandora, Idagio, LiveXLive, Primephonic, SiriusXM Essential, SiriusXM Premier, and YouTube Music, we listened to mixtapes. We compiled tracks on iTunes and burned them onto CD-Rs. We traded them with each other. We freely listened in our car or at home or with our portable CD player. And it was good.

Today we might spend an eternity making the perfect playlist for someone special, only to learn they’re on the Z Music Unlimited service while you’re on X Music Basic. Now, vendor lock-in means love lock-out. Our connections are disconnected. Our romantic hopes aren’t high enough for the surrounding paywalls. What can we do?

A Modern Mixtape

This is a static site generator for “burning” a modern mixtape. It’s platform-independent and won’t get scratched up in your car.

Run this program inside a directory of music files to produce a bare-bones HTML page that will simply play the music for someone. Upload it all to your website, and share the URL. Boom, you have a mixtape.

This only takes care of “burning the CD,” if you will -- then it’s up to you to make it special, like you would a normal mixtape. Add track notes, make it look cool or funky, do something that takes a little more effort than sharing a freaking Spotify playlist. All this tech convenience has made us lazy and boring. So make something interesting! Show someone that they mean something to you!

The Process

First, compile a collection of music files you’d like to put on a mixtape, and rename them according to the order you want, where each file name starts with a two-digit track number (i.e. 01, 02, ... 10, 11).


cdr Usage

  1. Install cdr with go get
  2. Create a directory for your playlist
  3. Add audio files into the directory
  4. Make sure they’re named in the order you want, and start with a two-digit track number, e.g. 01 - Track 1.mp3
  5. Run cdr clean in this directory to standardize the file names based on their metadata (supports ID3, MP4, OGG, FLAC)
  6. Run cdr burn in this directory to generate your mixtape page
  7. Open your new index.html in your browser!

This gives you the basic HTML. Now have fun with it.


You can also tweak the original template before it generates the final page.

  1. Copy mixtape.tmpl into your mixtape directory
  2. Edit this file to your liking, being sure to retain the {{template ...}} lines in the file
  3. Run cdr burn -- it’ll generate your page from this template instead of the default!

Template parts

These are the full template codes you can use to include certain elements.

Player + Playlist

This shows the audio player with play / pause actions, plus the playlist. You don’t need to use any other template codes beyond this.

{{template "full-player" .Tracks}}

Granular Elements

Optionally, you can use these more granular template codes for better control over your mixtape.

IMPORTANT! When using anything besides the full-player code, you will ALWAYS want to include the following code in your template. Otherwise your mixtape won’t work well!

{{template "playlist-js"}}


Shows only the audio player.

{{template "player" .Tracks}}


Show the playlist of tracks on the mixtape.

{{template "playlist" .Tracks}}


Requires Go 1.16 and above.


   CD-R 700MB - A static mixtape site generator

   cdr [global options] command [command options] [arguments...]


   burn     generate the static mixtape site
   preview  serve the mixtape site
   clean    clean and organize audio files in the current directory
   help, h  Shows a list of commands or help for one command

   --help, -h     show help (default: false)
   --version, -v  print the version (default: false)