poca-subscribe¶

Help¶

usage: poca-subscribe [-h] [-c CONFIG]
                      {add,list,tags,delete,toggle,stats} ...

poca-subscribe 1.1 : A subscription management tool for poca

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Use alternate config directory

commands:
  'poca-subscribe command --help' for futher information

  {add,list,tags,delete,toggle,stats}
    add                 Add a new subscription interactively
    list                List current subscriptions
    tags                List available id3 tags
    delete              Remove subscription, delete files
    toggle              Set state of current subscriptions
    stats               Get feed stats for current subscriptions

Each command also has it’s own set of flags/arguments. Run poca-subscribe [command] --help to see them.

Commands¶

add¶

Add a subscription. add starts up a step-by-step setup assistant that allows you to enter a title, url, max_number setting etc. Once completed, the resulting subscription is added to your poca.xml. Does not at the moment allow for metadata and filters settings to be added.

This is an easy-to-use way to quickly add some subscriptions if you’re not entirely comfortable editing xml.

stats¶

Get some basic stats on a current subscription. Use -t [title] for matching against the subscription title, -u [url] for matching against the url (e.g. check all subs from the BBC). If no matching is done it will loop through all current subs. Prints:

publishing frequency over the past five weeks (how many episodes and on what weekdays they publish)
latest episode title and date
average size (Mb) and length (hours:minutes) of an episode

stats is automatically called when using add after entering a url.

Example:

PYTHON BYTES
Author: Michael Kennedy                                  PUBLISHED / 5 WEEKS
Title:  Python Bytes

Last episode: #29 Responsive Bar Charts with Bokeh
Published:    08 Jun 2017                                             ▮
                                                                   ▮  ▮
Avg. size of episode:   15 Mb                                      ▮  ▮
Avg. length of episode: 20m                               M  T  W  T  F  S  S

delete¶

Delete a subscription. Goes through all subscriptions and asks you to decide on delete/keep. List can be narrowed using the command-specific -t/--title TITLE or -u/--url URL parameters.

toggle¶

Toggle the state attribute of a subscription between active and inactive. Goes through all subscriptions and asks you to decide on setting as active or inactive. Inactive subscriptions are not updated. Subscriptions with no state attribute are considered active. List can be narrowed using the command-specific -t/--title TITLE or -u/--url URL parameters.

list¶

Prints out a list of subscriptions. List is sorted by category attribute if any are present.

tags¶

Prints out all useable tags (use grep/less) for either mp3 or mp4 (use -3/-4 flags to get the relevant list).

Poca uses Mutagen’s EasyID3 editor so it understands sensible tag names, i.e.

Don’t:

<metadata>
    <TALB>Call of the Wild<TALB>
</metadata>

Do:

<metadata>
    <album>Call of the Wild<album>
</metadata>

Ogg, FLAC et al. use VorbisComment with no restrictions on tag names (though there are conventions).