Faircamp Manual Faircamp ☰

Downloads

By default your visitors can only stream your releases. There are four mutually exclusive download modes you can enable for each release:

Free downloads – free

For example, to enable free downloads in Opus format:

# download

free

format: opus

External downloads – external

If you want to use your faircamp site purely to let people stream your audio, but there is still a place elsewhere on the web where your release(s) can be downloaded, the external option allows you to display a download button that merely takes people to the external download page.

For example, to display a download button that should take people to https://example.com/my-release/:

# download

external: https://example.com/my-release/

Unlock code(s) – code or codes

An unlock code (like a coupon/token) needs to entered to access downloads.

For example, enabling FLAC and Opus downloads for people who received your download code "crowdfunding2023!" for backing you:

# download

code: crowdfunding2023!

-- unlock_text
You should have received the unlock code in your confirmation mail
for this year's crowdfunding. Stay tuned in case you missed it,
we're currently planning the next run!
-- unlock_text

formats:
- flac
- opus

unlock_text can be (optionally) used to provide a custom text to display on the page where your visitors can enter the unlock code.

Or for example, if you have subscribers in multiple tiers, you can configure access with multiple codes:

# download

codes:
- GOLDsupporter
- SILVERsupporter

formats:
- mp3
- opus

Soft Paycurtain – price

A soft (i.e. not technically enforced) paycurtain needs to be passed before downloading.

The idea here is simply that you name a price and provide external links to one or more payment, donation or patronage platforms that you use, be it liberapay, ko-fi, paypal, stripe, you name it. You could also link to bandcamp if you want to use it in parallel with your faircamp site.

For example in order to ask for 4€ for accessing the FLAC downloads on a release:

# download

price: EUR 4+

-- payment_text
Most easily you can transfer the money for your purchase
via my [liberapay account](https://liberapay.com/somewhatsynthwave)

Another option is supporting me through my [ko-fi page](https://ko-fi.com/satanclaus92)

If you're in europe you can send the money via SEPA, contact me at
[lila@thatawesomeartist42.com](mailto:lila@thatawesomeartist42.com) and I'll
send you the account details.

On Dec 19th I'm playing a show at *Substage Indenhoven* - you can get the
digital album now and meet me at the merch stand in december in person to give
me the money yourself as well, make sure to make a note of it though! :)
-- payment_text

format: flac

The price option accepts an ISO 4217 currency code and a price range such as:

In conjunction with the price you then describe where or how the payment can be made (as faircamp itself does not handle payments). This is done inside the payment_text field, in which you can use Markdown to place links, bullet points, etc.

Disabled – disabled

Disable downloads for specific releases when they have been enabled in a manifest above in the hierarchy.

# download

disabled

Offering single files for download

By default, the generated site will only offer complete download archives with all files of a release (tracks, cover, extras) included.

Downloads of single files of a release can be enabled in addition, but be aware that this significantly increases the required storage space for the generated site:

# download

single_files: enabled

In some cases it may be preferable to only offer single file downloads, entirely disabling the generation and offering of complete download archives. This will usually require a little more space (but in some circumstances also a little less space) than offering only complete download archives:

# download

single_files: only

To restore the default behavior of offering complete download archives only, when you've overriden it in some way in a parent manifest:

# download

single_files: disabled

All formats

Lastly here's a listing of all download formats you can currently enable. In practice a minimal combination of a lossy state of the art format (e.g. opus), a lossy format with high compatibility (e.g. mp3) and a lossless format (e.g. flac) is recommended.

formats:
- aac
- aiff
- alac
- flac
- mp3
- ogg_vorbis
- opus
- opus_48
- opus_96
- opus_128
- wav

Note that opus is an alias for opus_128.

Next page: Theme