flinck 0.3.1

Sort your movies on filesystem using symlinks.

.. image:: https://travis-ci.org/Kraymer/flinck.svg?branch=master
:target: https://travis-ci.org/Kraymer/flinck
.. image:: http://img.shields.io/pypi/v/flinck.svg
:target: https://pypi.python.org/pypi/flinck
|
.. image:: https://raw.githubusercontent.com/Kraymer/flinck/master/docs/_static/logo.png

=====

[flingk]
*verb tr.* To create a symlink to a movie (flick)


Description
-----------

CLI tool to organize your movies into a browsable directory tree offering fast access by dates, imdb ratings, etc

.. image:: https://raw.githubusercontent.com/Kraymer/flinck/master/docs/_static/screenshot.png

Features
--------

- smart extraction of movie name from its folder/file, use `OMDB`_ api to get infos
- sane limited set of configuration options, yet highly flexible directories resulting structure
- possible to split links into alphabetical buckets (A-C, D-F, etc) for large libraries

.. _OMDB: http://www.omdbapi.com/

Install
-------

flinck is written for `Python 2.7`_ and `Python 3`_.

Install with `pip`_ via ``pip install flinck`` command.

If you're on Windows and don't have pip yet, follow
`this guide`_ to install it.

.. _Python 2.7: https://www.python.org/downloads/
.. _Python 3: https://www.python.org/downloads/
.. _pip: https://pip.pypa.io/en/stable/
.. _this guide: https://pip.pypa.io/en/latest/installing/

Usage
-----

::

Usage: flinck.py [OPTIONS] FILE|DIR

Organize your movie collection using symbolic links.

Options:
-l, --link_dir PATH Links root directory
-b, --by [country|decade|director|genre|rating|runtime|title|year]
Organize medias by...
-v, --verbose
--version Show the version and exit.
-h, --help Show this message and exit.

Example: flinck -l ./ --by genre --by rating ~/Movies

More infos on `Wiki`_

.. _Wiki: https://github.com/Kraymer/flinck/wiki

Configuration
-------------

``~/.config/flinck/config.yaml`` corresponding to the screenshot above : ::

link_root_dir: '/Volumes/Disque dur/Movies'

genre:
dirs: true
buckets: true

rating:
link_format: %rating-%year-%title
dirs: false
buckets: true

decade:
dirs: true

Top settings:

- **link_root_dir**: where the folders tree will be created. Must exist beforehand.
- **file_extensions**: files types to consider. Default: ``['avi', 'm4v', 'mkv', 'mp4']``
- **file_min_size_mb**: files whose size is below that threshold are ignored. Default: ``20``
- **google_api_key**: your `Google API key`_ (to enable the Google Custom Search backend)

Then, you can define a section for each metadata field you want to sort by.
Inside it, available settings are :

- **root**: root dirname (or relative path from ``link_root_dir``) for this metadata field. Default: the metadata field name.
- **link_format**: symlink naming format. Default: ``%title-%field``
- **dirs**: put symlinks into an intermediary directory named after the field value. Default: ``no``
- **buckets**: put symlinks into a parent matching directory if it does exist. Any directory that contains the field value or defines a matching range is valid.
A range is defined by ``[]`` chars, eg *[A-D]* directory matches *Drama* genre field value.

.. _Google API key: https://code.google.com/apis/console

Changelog
---------

Available on `Github Releases page`_.

Want to know when new releases are shipped? Subscribe to the `Versions rss feed`_.

.. _Versions rss feed: http://createfeed.fivefilters.org/extract.php?url=https%3A%2F%2Fgithub.com%2FKraymer%2Fflinck%2Freleases&in_id_or_class=release-title&url_contains=
.. _Github Releases page: https://github.com/Kraymer/flinck/releases

Feedbacks
---------

Please submit bugs and features requests on the `Issue tracker`_.

.. _Issue tracker: https://github.com/Kraymer/flinck/issues