Faircamp

Faircamp on Windows

Get started on Windows

Tutorial Overview

This tutorial will guide you through installing faircamp, generating your first faircamp site, customizing it further through the use of manifests, and finally show you one (of many) ways to publish your site online.

Install faircamp

Download and run the Windows Installer (64-bit), then continue with the next step below.

Create your catalog folder

First, open your file explorer and create an empty directory in which we'll put your audio files and other data for the website (the catalog directory). It's name and location can be freely chosen, but for instance you could name it simply Catalog and put it in your Documents folder.

Add releases

Now you can fill the catalog directory with your audio material. Each release (single/album/episode/...) should have its own subdirectory (the release directory), into which you place the audio files (and optionally, cover image). You can also add further hierarchical organization by putting multiple releases in a containing folder (e.g. organizing by artist or by year) but this is optional and has no effect on the website later - faircamp will only group your audio material by release.

Note that you can always add more material later, so adding one or two release here will suffice for a first test. Add as many releases as you want, then move to the next step.

Run faircamp

Still in your file explorer, move to the directory that contains your catalog folder, so that you are ready to drag and drop the catalog folder itself (which we will do in a second).

Now open the start menu and begin typing the words "Command Prompt". You won't need to type it out in full as Windows will likely suggest the application of that name already after the first few letters - just type until you are offered the suggestion, then click on it. Inside the command prompt, type cd (this stands for "Change directory"), then press Space (this serves as a separator), and now drag and drop your catalog folder from your file explorer to the command prompt window. The active prompt line in your command prompt should now display something like cd C:\Example\Your Catalog\, and you can confirm the command (and thereby change directory) by pressing Enter.

Finally, to run faircamp inside your catalog folder (which we are now in), type faircamp.exe --preview and press Enter. Faircamp will now process your files, generate your website, and directly open the result in your browser (the latter because we added the --preview flag). Congratulations: You created your first faircamp site! Feel free to play around with the result, then come back to the next steps for learning how to customize it.

Customize the catalog

Text coming soon!

Customize a release

Text coming soon!

Customize the theme

Text coming soon!

Next steps coming soon!

This guide is currently being written/extended, augmented with screenshots/gifs, etc. Please check back the next days. In the meanwhile, or in general, check out Meljoann's great faircamp introduction.