Skip to content
Snippets Groups Projects
poca.xml 2.49 KiB
Newer Older
nimrod's avatar
nimrod committed
<poca version="0.8">
  <!-- Please see detailed configuration documentation online:
     https://github.com/brokkr/poca/wiki/Configuration -->
  <!-- The meaning of the settings options are briefly as follows:
    * base_dir: Directory containing the individual subscription folders
    * id3encoding: Encoding to use on metadata (utf8 or latin1)
    * id3removev1: Should we remove id3v1, only keeping v2 (yes or no)
    * useragent: _Fallback_ user agent if connection is rejected for
      default python user agent. Leave empty not to use a fallback.
    * email logging setup not included by default, see wiki for details.
    -->
  <settings>
    <base_dir>/srv/library/nimrod/Podcasts</base_dir>
    <id3encoding>utf8</id3encoding>
    <id3removev1>yes</id3removev1>
    <useragent/>
  </settings>
  <!-- Defaults take the same options as any single subscription. A
    setting here, e.g. max_number, is applied to all subscriptions but
    always overruled by sub-specific settings. Non-overruling settings in
    metadata and filters are combined, e.g. a sub-specific 'artist' tag and
    a global 'genre' tag -->
  <defaults>
    </defaults>
  <subscriptions>
    <!-- The meaning of the subscription options are brifly as follows:
        * category: A category attribute on a subscription tag is helpful in 
                    organizing the output of 'poca-subscribe list'.
        * state: A state attribute is either 'active' or 'inactive'. inactive
                 subs are not updated. subs without state attribute are active.
        * title: Name used for the folder of the subscription (required)
        * url: The address of the rss feed (required)
        * max_number: Max number of files to keep in subscription (optional)
        * from_the_top: Get oldest files first, not newest (optional)
        * metadata: Override id3 header fields with these values
          (see https://github.com/brokkr/poca/wiki/ID3-frames for details)
        * filters: Contains one or more of following tags (all optional)
          * filename: Filename of the entry must match this string/regex
          * title: Same as above, only for the title in the rss 
          * hour: The hour (24h-format) at which the entry was published.
          * weekdays: Only entries from one of these weekdays (as integers)
          * after_date: Only use entries published after date specified.
        -->
    <subscription>
      <url>http://feeds.twit.tv/floss.xml</url>
      <title>Floss Weekly</title>
    </subscription>
  </subscriptions>
</poca>