Skip to content

Commit f9ce1fa

Browse files
committed
user-manual.md: rework custom filenames explanation some
1 parent 11bfbb3 commit f9ce1fa

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

docs/user-manual.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -283,9 +283,23 @@ Preferences dialog.
283283

284284
You can use custom file names when synchronising. This makes browsing files on your device much more convenient.
285285

286-
The default value for the custom filename field is {episode.sortdate}_{episode.title}. This will work for most podcasts. However, occasionally you may find a podcast where the producers don't provide unique information in the tags, which can result in multiple episodes being given the same name (e.g. podcast.mp3), and thus overwriting one another on synchronisation. One workaround to this is to include the {episode.sortdate} data. Multiple fields can be concatenated, e.g.: "{episode.sortdate}\_{episode.basename}" which will result in files of the form "2012-01-14\_podcast.mp3".
286+
The default value for the custom filename field is `{episode.sortdate}_{episode.title}`.
287287

288-
For podcasts that release multiple episodes on the same day, even this might not be enough. Try also {episode.sortdate}\_{episode.title}, or even {episode.sortdate}\_{episode.published}
288+
Some of the available tags are:
289+
- `{episode.basename}`
290+
- `{episode.title}`
291+
- `{episode.sortdate}`
292+
- `{episode.published}`
293+
- `{podcast.title}`
294+
- `{podcast.id}`
295+
296+
`{episode.basename}` is the episode's filename in gPodder's download folder.
297+
298+
Note that tags for both the episode and the podcast channel are available. The above is by no means an exhaustive list of the tags available, but represents some of the more useful ones.
299+
300+
Multiple fields can be concatenated, e.g.: `{episode.sortdate}_{episode.basename}` which will result in files of the form `2012-01-14_podcast.mp3`.
301+
302+
Occasionally you may find a podcast where the producers don't provide unique information in the tags, which can result in multiple episodes being given the same name (e.g. podcast.mp3), and thus overwriting one another on synchronisation. In this case the tags `{episode.sortdate}` and `{episode.published}` can be useful to create unique filenames.
289303

290304
Both playlist creation and the ability to remove episodes from gPodder by deleting them from the device will work with custom file names enabled.
291305

0 commit comments

Comments
 (0)