{"id":15698386,"url":"https://github.com/nekmo/random-episode","last_synced_at":"2025-10-13T01:04:43.652Z","repository":{"id":57459848,"uuid":"75736992","full_name":"Nekmo/random-episode","owner":"Nekmo","description":"Play a random chapter of your favorite series, like The Simpsons, Futurama, Friends...","archived":false,"fork":false,"pushed_at":"2018-08-01T00:00:22.000Z","size":1902,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-09T01:16:12.205Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nekmo.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-06T14:05:29.000Z","updated_at":"2024-08-13T14:18:26.000Z","dependencies_parsed_at":"2022-09-09T23:02:42.486Z","dependency_job_id":null,"html_url":"https://github.com/Nekmo/random-episode","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nekmo%2Frandom-episode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nekmo%2Frandom-episode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nekmo%2Frandom-episode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nekmo%2Frandom-episode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nekmo","download_url":"https://codeload.github.com/Nekmo/random-episode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171272,"owners_count":21865297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T19:26:28.528Z","updated_at":"2025-10-13T01:04:38.620Z","avatar_url":"https://github.com/Nekmo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n.. image:: https://raw.githubusercontent.com/Nekmo/random-episode/master/random-episode.png\n    :width: 100%\n\n|\n\n.. image:: https://img.shields.io/pypi/v/random-episode.svg?style=flat-square\n  :target: https://pypi.org/project/random-episode/\n  :alt: Latest PyPI version\n\n.. image:: https://img.shields.io/pypi/pyversions/random-episode.svg?style=flat-square\n  :target: https://pypi.org/project/random-episode/\n  :alt: Python versions\n\n.. image:: https://img.shields.io/codeclimate/github/Nekmo/random-episode.svg?style=flat-square\n  :target: https://codeclimate.com/github/Nekmo/random-episode\n  :alt: Code Climate\n\n.. image:: https://img.shields.io/requires/github/Nekmo/random-episode.svg?style=flat-square\n     :target: https://requires.io/github/Nekmo/random-episode/requirements/?branch=master\n     :alt: Requirements Status\n\n\n\nPlay Random Episode\n###################\nPlay a random chapter of your favorite series, like *The Simpsons*, *Futurama*, *Friends*...\n\nWith this program you can:\n\n- Define **multiple directories** as a source.\n- Optional support for **subdirectories**.\n- Use **patterns** to filter files.\n- Choose a **video player**, or let it choose one automatically.\n- Native support for **chromecast**.\n\nHow to use it\n=============\n\nBy default, it plays a video of the current directory with the default player.\n\n.. code-block:: bash\n\n    # Use current directory\n    $ random-player\n\nThe syntax is:\n\n.. code-block:: bash\n\n    $ random-player[ --config \u003cconfig_path\u003e][ \u003cplayer\u003e[ \u003cplaylist\u003e]]\n\n\nThe available parameters are:\n\n* ``\u003cconfig_path\u003e``: by default it is ``random-episode.yml``.\n* ``\u003cplayer\u003e``: by default it is ``native`` (default video player). ``chromecast`` is also available.\nYou can define others in the configuration.\n* ``\u003cplaylist\u003e``: you must define the playlists in the configuration.\n\n\nConfiguration\n=============\nUsing a configuration file you can define playlists and players. An example:\n\n.. code-block:: yaml\n\n    # random-episode.yml\n    # ------------------\n\n    playlists:\n        groening:  # playlist name\n            directories:  # Multiple directories\n              - '/path/to/simpsons/'\n              - '/path/to/futurama/'\n            recursive: true  # Optional\n            patterns:  # Optional\n              - '*.mkv'  # file pattern\n              - '*.mp4'\n              - '*.avi'\n        simpsons-t1:  # playlist name\n            directories: '/path/to/simpsons/The Simpsons/'\n            patterns: 'The Simpsons 1x*'\n    players:\n        bedroom-chromecast:  # player name\n            type: chromecast  # chromecast or native\n            # Chromecast name. Useful if you have more than one\n            name: bedroom\n        vlc:  # player name\n            # default type: native\n            cmd: vlc  # command to execute\n\n\nThe options are:\n\n* **playlists**:\n    * **directories**: required. A list or just one.\n    * **recursive**: optional. ``true`` or ``false``. Search for episodes recursively into subdirectories,\n    * **patterns**: optional. A list or just one. Check the file names.\n* **players**: by default chromecast (with type chromecast) and native (with type native).\n    * **type**: optional. By default native.\n    * **cmd**: Command to execute in native type.\n\n\nInstall\n=======\nIf you have ``pip`` installed, you can install it with:\n\n.. code:: bash\n\n    sudo pip install random-episode\n\n\nAmazon Dash\n===========\nIt's easy to use Random Episode with your Amazon Dash. You just need to install::\n\n    $ pip install amazon-dash\n\nThen configure in Amazon Dash:\n\n.. code:: yaml\n\n    # amazon-dash.yml\n    # ---------------\n\n    44:65:0D:48:FA:88:\n      name: Pompadour\n      user: nekmo\n      cmd: random-episode chromecast simpsons\n\n\nLicense\n=======\nThis project is under the MIT license.\n\n*The Simpsons*, *The simpsons logo image* and *Futurama* are owned by 20th Century Fox Television.\n*Friends* is owned by Warner Bros. Television.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnekmo%2Frandom-episode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnekmo%2Frandom-episode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnekmo%2Frandom-episode/lists"}