Update README and setup.py
This commit is contained in:
parent
5c4c771bc5
commit
2f4ffa73ae
2 changed files with 28 additions and 13 deletions
33
README.md
33
README.md
|
@ -5,12 +5,15 @@
|
||||||
A program for managing & catching podcasts from the terminal.
|
A program for managing & catching podcasts from the terminal.
|
||||||
|
|
||||||
Work in Progress and unfinished. Use at your own risk.
|
Work in Progress and unfinished. Use at your own risk.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
requires feedparser, requests and colorama
|
requires feedparser, requests, colorama and tqdm
|
||||||
|
|
||||||
install automatically via pip:
|
```
|
||||||
|
git clone https://github.com/mwalbeck/podfox.git
|
||||||
```pip install podfox```
|
cd podfox
|
||||||
|
python3 setup.py install
|
||||||
|
```
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
|
@ -18,13 +21,25 @@ podfox main configuration file is called `.podfox.json` and should be located in
|
||||||
Here is mine:
|
Here is mine:
|
||||||
```
|
```
|
||||||
{
|
{
|
||||||
"podcast-directory" : "/home/basti/podcasts",
|
"podcast-directory" : "/home/<USER>/podcasts",
|
||||||
"maxnum" : 5
|
"maxnum" : 5,
|
||||||
|
"cover-image" : true,
|
||||||
|
"cover-image-name" : "folder",
|
||||||
|
"rename-episodes" : true,
|
||||||
|
"date-format" : "%Y-%m-%d",
|
||||||
|
"connection-timeout" : 10,
|
||||||
|
"conncetion-retries" : 3
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
`podcast-directory` is your main directory to store podcast data. This directory should be empty before you
|
* `podcast-directory` is your main directory to store podcast data. This directory should be empty before you begin adding feeds.
|
||||||
begin adding feeds.
|
* `maxnum` describes the maximum number of episodes you want to download with a single `download`-command. -1 for no limit.
|
||||||
`maxnum` describes the maximum number of episodes you want to download with a single `download`-command.
|
* `cover-image` *(optional)* boolean value to enable downloading of podcast image (default is `false`)
|
||||||
|
* `cover-image-name` *(optional)* custom name for the image (default is `folder`)
|
||||||
|
* `rename-episodes` *(optional)* boolean value to enable renaming of podcast episodes (default is `false`)
|
||||||
|
* `date-format` *(optional)* formatting for the date when renaming episodes (default is `%Y-%m-%d`)
|
||||||
|
* `connection-timeout` *(optional)* int in seconds for how long to wait before timeout (default is `10`)
|
||||||
|
* `connection-retries` *(optional)* int for how many retries per podcast episode before moving on to next episode if there is connection problems (default is `3`)
|
||||||
|
|
||||||
|
|
||||||
## Directory Structure
|
## Directory Structure
|
||||||
|
|
||||||
|
|
8
setup.py
8
setup.py
|
@ -4,11 +4,11 @@ with open('requirements.txt') as f:
|
||||||
required = f.read().splitlines()
|
required = f.read().splitlines()
|
||||||
|
|
||||||
setup(name='podfox',
|
setup(name='podfox',
|
||||||
version='0.1.1',
|
version='0.1.3',
|
||||||
description='Podcatcher for the terminal',
|
description='Podcatcher for the terminal',
|
||||||
url='http://github.com/brtmr/podfox',
|
url='http://github.com/mwalbeck/podfox',
|
||||||
author='Bastian Reitemeier',
|
author='Magnus Walbeck',
|
||||||
author_email='mail@brtmr.de',
|
author_email='mw@mwalbeck.org',
|
||||||
license='GPLv3',
|
license='GPLv3',
|
||||||
packages=['podfox'],
|
packages=['podfox'],
|
||||||
zip_safe=False,
|
zip_safe=False,
|
||||||
|
|
Loading…
Add table
Reference in a new issue