A personal media manager program
Project description
Tok Tokkie Media Manager
========================
+------------------+------------------+
| master | develop |
+==================+==================+
| |build status| | |build status| |
+------------------+------------------+
.. figure:: resources/logo/logo-readme.png
:alt: Logo
Logo
An multi-purpose media manager
Installation
------------
Via Pip (Preferred):
~~~~~~~~~~~~~~~~~~~~
**As User (Preferred)**
::
$ pip install toktokkie --user
**Systemwide**
::
# pip install toktokkie
or
$ sudo pip install toktokkie
Via setup.py
~~~~~~~~~~~~
**As User (Preferred)**
::
$ python setup.py install --user
**Systemwide**
::
# python setup.py install
or
$ sudo python setup.py install
Binaries
~~~~~~~~
The supplied binaries at the `Github
Releases <https://github.com/namboy94/toktokkie/releases>`__ page do not
require installation nor any dependencies. They can simply be executed.
Functionality
-------------
The software is primarily used to automate various media managing tasks,
ranging from renaming files, applying Folder icons or downloading files.
To do this, the program is built upon a couple of assumptions:
Your media directories must have a subdirectory called ``.meta``. In
this subdirectory, there can be various different files used by
toktokkie, but at the very least a simple text file called ``type`` with
the content describing which type of content the directory represents.
Currently supported are:
- ``tv_series``
So in general, a typical media directory would be structured like this:
::
-Some TV Show
|-- Season 1
|-- Episode 1.mkv
|-- ...
|-- Episode n.mkv
|-- Extras
|-- Director Commentary.mkv
|-- .meta
|-- type (Content: tv_series)
|-- icons
|-- Season 1.png
|-- Season 1.ico
|-- main.png
|-- main.ico
Directories with a structure like this can then be used by toktokkie.
Any directories that are automatically generated by toktokkie are
already initialized like this.
The toktokkie program consists of several modules, each offering a
textual UI and a graphical UI. Information on the individual modules are
linked below:
- `Folder Iconizer <doc/markdown/folder_iconizer.md>`__
- `TV Episode Renamer <doc/markdown/tv_episode_renamer.md>`__
- `XDCC Download Manager <doc/markdown/xdcc_download_manager.md>`__
- `XDCC Update <doc/markdown/xdcc_update.md>`__
External Integrations
~~~~~~~~~~~~~~~~~~~~~
toktokkie als integrates a number of external GUIs and TUIs:
- `XDCC Downloader <https://gitlab.namibsun.net/namboy94/>`__
Further Information
-------------------
- `Changelog <https://gitlab.namibsun.net/namboy94/toktokkie/raw/master/CHANGELOG>`__
- `License
(GPLv3) <https://gitlab.namibsun.net/namboy94/toktokkie/raw/master/LICENSE>`__
- `Gitlab <https://gitlab.namibsun.net/namboy94/toktokkie>`__
- `Github <https://github.com/namboy94/toktokkie>`__
- `Python Package Index
Site <https://pypi.python.org/pypi/toktokkie>`__
- `Documentation(HTML) <https://docs.namibsun.net/html_docs/toktokkie/index.html>`__
- `Documentation(PDF) <https://docs.namibsun.net/pdf_docs/toktokkie.pdf>`__
- `Git Statistics
(gitstats) <https://gitstats.namibsun.net/gitstats/toktokkie/index.html>`__
- `Git Statistics
(git\_stats) <https://gitstats.namibsun.net/git_stats/toktokkie/index.html>`__
- `Test
Coverage <https://coverage.namibsun.net/toktokkie/index.html>`__
.. |build status| image:: https://gitlab.namibsun.net/namboy94/toktokkie/badges/master/build.svg
:target: https://gitlab.namibsun.net/namboy94/toktokkie/commits/master
.. |build status| image:: https://gitlab.namibsun.net/namboy94/toktokkie/badges/develop/build.svg
:target: https://gitlab.namibsun.net/namboy94/toktokkie/commits/develop
========================
+------------------+------------------+
| master | develop |
+==================+==================+
| |build status| | |build status| |
+------------------+------------------+
.. figure:: resources/logo/logo-readme.png
:alt: Logo
Logo
An multi-purpose media manager
Installation
------------
Via Pip (Preferred):
~~~~~~~~~~~~~~~~~~~~
**As User (Preferred)**
::
$ pip install toktokkie --user
**Systemwide**
::
# pip install toktokkie
or
$ sudo pip install toktokkie
Via setup.py
~~~~~~~~~~~~
**As User (Preferred)**
::
$ python setup.py install --user
**Systemwide**
::
# python setup.py install
or
$ sudo python setup.py install
Binaries
~~~~~~~~
The supplied binaries at the `Github
Releases <https://github.com/namboy94/toktokkie/releases>`__ page do not
require installation nor any dependencies. They can simply be executed.
Functionality
-------------
The software is primarily used to automate various media managing tasks,
ranging from renaming files, applying Folder icons or downloading files.
To do this, the program is built upon a couple of assumptions:
Your media directories must have a subdirectory called ``.meta``. In
this subdirectory, there can be various different files used by
toktokkie, but at the very least a simple text file called ``type`` with
the content describing which type of content the directory represents.
Currently supported are:
- ``tv_series``
So in general, a typical media directory would be structured like this:
::
-Some TV Show
|-- Season 1
|-- Episode 1.mkv
|-- ...
|-- Episode n.mkv
|-- Extras
|-- Director Commentary.mkv
|-- .meta
|-- type (Content: tv_series)
|-- icons
|-- Season 1.png
|-- Season 1.ico
|-- main.png
|-- main.ico
Directories with a structure like this can then be used by toktokkie.
Any directories that are automatically generated by toktokkie are
already initialized like this.
The toktokkie program consists of several modules, each offering a
textual UI and a graphical UI. Information on the individual modules are
linked below:
- `Folder Iconizer <doc/markdown/folder_iconizer.md>`__
- `TV Episode Renamer <doc/markdown/tv_episode_renamer.md>`__
- `XDCC Download Manager <doc/markdown/xdcc_download_manager.md>`__
- `XDCC Update <doc/markdown/xdcc_update.md>`__
External Integrations
~~~~~~~~~~~~~~~~~~~~~
toktokkie als integrates a number of external GUIs and TUIs:
- `XDCC Downloader <https://gitlab.namibsun.net/namboy94/>`__
Further Information
-------------------
- `Changelog <https://gitlab.namibsun.net/namboy94/toktokkie/raw/master/CHANGELOG>`__
- `License
(GPLv3) <https://gitlab.namibsun.net/namboy94/toktokkie/raw/master/LICENSE>`__
- `Gitlab <https://gitlab.namibsun.net/namboy94/toktokkie>`__
- `Github <https://github.com/namboy94/toktokkie>`__
- `Python Package Index
Site <https://pypi.python.org/pypi/toktokkie>`__
- `Documentation(HTML) <https://docs.namibsun.net/html_docs/toktokkie/index.html>`__
- `Documentation(PDF) <https://docs.namibsun.net/pdf_docs/toktokkie.pdf>`__
- `Git Statistics
(gitstats) <https://gitstats.namibsun.net/gitstats/toktokkie/index.html>`__
- `Git Statistics
(git\_stats) <https://gitstats.namibsun.net/git_stats/toktokkie/index.html>`__
- `Test
Coverage <https://coverage.namibsun.net/toktokkie/index.html>`__
.. |build status| image:: https://gitlab.namibsun.net/namboy94/toktokkie/badges/master/build.svg
:target: https://gitlab.namibsun.net/namboy94/toktokkie/commits/master
.. |build status| image:: https://gitlab.namibsun.net/namboy94/toktokkie/badges/develop/build.svg
:target: https://gitlab.namibsun.net/namboy94/toktokkie/commits/develop
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
toktokkie-0.15.0.tar.gz
(69.8 kB
view hashes)
Built Distributions
toktokkie-0.15.0-py3-none-any.whl
(152.3 kB
view hashes)
toktokkie-0.15.0-py2-none-any.whl
(289.9 kB
view hashes)
Close
Hashes for toktokkie-0.15.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45125fc346bf62a730d1f4a97959838446197b7fe40a6ae71ba544918180cbaa |
|
MD5 | 2040fc81b6dd92b16a058f8647ff8af6 |
|
BLAKE2b-256 | ad00ea1574c44f5ecddfea5a35993d2d102686f124c62b07d629e533a252f29f |
Close
Hashes for toktokkie-0.15.0-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 99a738010c090859a763658045f691532e0d8de10cbdbdb4709a265378d38800 |
|
MD5 | ee0e73d095db7a1c015702b1e6b5d248 |
|
BLAKE2b-256 | 824c53ba1a964a0e019fac23ac49966ecad6dcc6f6622be94212f0f4ce76a1a1 |