iREADME.md - potcasse - Podcast publication made easy	Err	bitreich.org	70
hgit clone git://bitreich.org/potcasse git://hg6vgqziawt5s4dj.onion/potcasse	URL:git://bitreich.org/potcasse git://hg6vgqziawt5s4dj.onion/potcasse	bitreich.org	70
1Log	/scm/potcasse/log.gph	bitreich.org	70
1Files	/scm/potcasse/files.gph	bitreich.org	70
1Refs	/scm/potcasse/refs.gph	bitreich.org	70
1Tags	/scm/potcasse/tag	bitreich.org	70
1README	/scm/potcasse/file/README.md.gph	bitreich.org	70
1LICENSE	/scm/potcasse/file/LICENSE.gph	bitreich.org	70
i---	Err	bitreich.org	70
iREADME.md (2493B)	Err	bitreich.org	70
i---	Err	bitreich.org	70
i     1 # Introduction	Err	bitreich.org	70
i     2 	Err	bitreich.org	70
i     3 potcasse, pronounced "pot kas" is meant to help people to publish and self host a podcast easily without using a third party service.	Err	bitreich.org	70
i     4 	Err	bitreich.org	70
i     5 # Dependencies	Err	bitreich.org	70
i     6 	Err	bitreich.org	70
i     7 * rsync (could use cp but avoid recopying audio files locally).	Err	bitreich.org	70
i     8 * a posix compatible OS (Linux, *BSD, Solaris).	Err	bitreich.org	70
i     9 * some webserver to host the files.	Err	bitreich.org	70
i    10 	Err	bitreich.org	70
i    11 # How to use	Err	bitreich.org	70
i    12 	Err	bitreich.org	70
i    13 The idea is to regroup audio files with their metadata in a directory and generate the structure that you will publish on a web server.	Err	bitreich.org	70
i    14 	Err	bitreich.org	70
i    15 A simple `index.html` file is also generated in the process to give an easy list without using the RSS file.	Err	bitreich.org	70
i    16 	Err	bitreich.org	70
i    17 ## First time	Err	bitreich.org	70
i    18 	Err	bitreich.org	70
i    19 ```	Err	bitreich.org	70
i    20 potcasse init	Err	bitreich.org	70
i    21 ```	Err	bitreich.org	70
i    22 	Err	bitreich.org	70
i    23 This will create a file `metadata.sh` that you need to edit accordingly to your setup.	Err	bitreich.org	70
i    24 	Err	bitreich.org	70
i    25 It has the following variables:	Err	bitreich.org	70
i    26 	Err	bitreich.org	70
i    27 + `TITLE`: this is the podcast title.	Err	bitreich.org	70
i    28 + `AUTHOR`: this is the podcast author (doesn't support multiples authors yet).	Err	bitreich.org	70
i    29 + `SITE`: base HTTP URL where your podcast will be available (for example `https://tilde.example/myname/podcast/`.	Err	bitreich.org	70
i    30 + `RSSLINK`: name of the RSS feed.	Err	bitreich.org	70
i    31 + `IMAGE`: if value is not empty, potcasse will use the file `logo.png`.	Err	bitreich.org	70
i    32 + `LANGUAGE`: language code (such as `fr` or `en-us`) that can be potentially used by some players.	Err	bitreich.org	70
i    33 	Err	bitreich.org	70
i    34 You will share the link `$SITE/index.html` or `$SITE/$RSSLINK` to your listeners.	Err	bitreich.org	70
i    35 	Err	bitreich.org	70
i    36 ## New episode	Err	bitreich.org	70
i    37 	Err	bitreich.org	70
i    38 ```	Err	bitreich.org	70
i    39 potcasse episode "Episode XX: trying something weird" /path/to/audio/file	Err	bitreich.org	70
i    40 ```	Err	bitreich.org	70
i    41 	Err	bitreich.org	70
i    42 This will create a directory episodes/YYYYMMDDhh so you can't publish more than a podcast every hour using this command.  The audio file inherits the directory name.	Err	bitreich.org	70
i    43 	Err	bitreich.org	70
i    44 You can force a directory name with a parameter after the audio file.	Err	bitreich.org	70
i    45 	Err	bitreich.org	70
i    46 ```	Err	bitreich.org	70
i    47 potcasse episode "Episode XX: trying something weird" /path/to/audio/file this_is_my_podcast_episode_i_want_to_name	Err	bitreich.org	70
i    48 ```	Err	bitreich.org	70
i    49 	Err	bitreich.org	70
i    50 ## Publishing	Err	bitreich.org	70
i    51 	Err	bitreich.org	70
i    52 ```	Err	bitreich.org	70
i    53 potcasse gen	Err	bitreich.org	70
i    54 ```	Err	bitreich.org	70
i    55 	Err	bitreich.org	70
i    56 this will create or update the `output_html` directory with your audio files, the RSS file, an index.html file listing all the episodes and the logo file if any.	Err	bitreich.org	70
i    57 	Err	bitreich.org	70
i    58 # Real world example	Err	bitreich.org	70
i    59 	Err	bitreich.org	70
i    60 My podcast feed is available at `https://perso.pw/lambda/feed.xml` which is on server `perso.pw` in `/var/www/htdocs/lambda/`.	Err	bitreich.org	70
i    61 	Err	bitreich.org	70
i    62 I add new episodes with `potcasse episode "A made something nice" ~/Podcast/episodeXX/file.ogg` then I use `potcasse gen` that will refresh the directory `public_html` with metadata and episodes, finally I put it online with `rsync -av public_html/ perso.pw:/var/www/htdocs/lamda/`.	Err	bitreich.org	70
i    63 	Err	bitreich.org	70
i    64 My `metadata.sh` looks like this:	Err	bitreich.org	70
i    65 	Err	bitreich.org	70
i    66 ```	Err	bitreich.org	70
i    67 TITLE="Lambda Solene"	Err	bitreich.org	70
i    68 AUTHOR=Solene	Err	bitreich.org	70
i    69 SITE=https://perso.pw/lambda/	Err	bitreich.org	70
i    70 RSSLINK=feed.xml	Err	bitreich.org	70
i    71 IMAGE=YES	Err	bitreich.org	70
i    72 ```	Err	bitreich.org	70
.