Metadata-Version: 2.2
Name: Mopidy-Pibox
Version: 2.2.0
Summary: Mopidy extension for jukebox client
Home-page: https://github.com/gbannerman/mopidy-pibox
Author: Gavin Bannerman
Author-email: pibox@gavinb.site
License: Apache License, Version 2.0
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.9
License-File: LICENSE
Requires-Dist: Mopidy>=3.0.0
Requires-Dist: Pykka>=2.0.1
Requires-Dist: PyGObject>=3.42
Requires-Dist: setuptools
Provides-Extra: lint
Requires-Dist: ruff==0.4.5; extra == "lint"
Requires-Dist: check-manifest; extra == "lint"
Provides-Extra: test
Requires-Dist: pytest==8.2.1; extra == "test"
Requires-Dist: pytest-cov==5.0.0; extra == "test"
Provides-Extra: dev
Requires-Dist: ruff==0.4.5; extra == "dev"
Requires-Dist: check-manifest; extra == "dev"
Requires-Dist: pytest==8.2.1; extra == "dev"
Requires-Dist: pytest-cov==5.0.0; extra == "dev"
Requires-Dist: tox; extra == "dev"

.. image:: https://raw.githubusercontent.com/gbannerman/mopidy-pibox/main/docs/screenshots/pibox-header.png

****************************
Mopidy-Pibox
****************************

.. image:: https://img.shields.io/pypi/v/Mopidy-Pibox.svg?style=flat
    :target: https://pypi.python.org/pypi/Mopidy-Pibox/
    :alt: Latest PyPI version

.. image:: https://github.com/gbannerman/mopidy-pibox/actions/workflows/ci.yml/badge.svg?branch=main
    :target: https://github.com/gbannerman/mopidy-pibox/releases
    :alt: GitHub Actions

.. image:: https://codecov.io/gh/gbannerman/mopidy-pibox/branch/main/graph/badge.svg?token=N4XSRNJUU3 
    :target: https://codecov.io/gh/gbannerman/mopidy-pibox
    :alt: Codecov


**pibox** is a Mopidy HTTP client that allows multiple users to search for and queue songs as a group, via a clean and simple interface.

Features
========
- Search for and queue songs using any Mopidy backend
- Vote to skip queued tracks
- Plays from predefined playlists if no tracks are queued
- Prevents tracks from being queued again after they have been played or skipped
- Admins controls to pause/resume playback or skip current track
- Display view for showing on a TV or monitor
- Suggests songs to queue based on frequently played tracks
- Can be used offline without an internet connection using Mopidy-Local_

.. image:: https://raw.githubusercontent.com/gbannerman/mopidy-pibox/main/docs/screenshots/pibox-mobile.png

.. _Mopidy-Local: https://mopidy.com/ext/local/


Requirements
============
- Mopidy_
- A backend for Mopidy such as Mopidy-Spotify_ or Mopidy-SoundCloud_

.. _Mopidy: https://docs.mopidy.com/en/latest/installation/
.. _Mopidy-Spotify: https://mopidy.com/ext/spotify/
.. _Mopidy-SoundCloud: https://mopidy.com/ext/soundcloud/

Installation
============

1. Install by running::

    pip install Mopidy-Pibox

2. Start Mopidy::
		
		mopidy

3. Open your Mopidy URL (e.g. `http://localhost:6680`) and click *Pibox*


Configuration
=============

Before starting Mopidy, you must add configuration for
Mopidy-Pibox to your Mopidy configuration file::

    [pibox]
    enabled = true
    offline = false
    default_skip_threshold = 3
    default_playlists =
      spotify:playlist:79inBfAlnfUB7i5kRthmWL

The following configuration values are available:

- ``pibox/enabled``: If the pibox extension should be enabled or not.
  Defaults to ``true``.

- ``pibox/offline``: If the extension should be used offline. Defaults to false.

- ``pibox/default_skip_threshold``: The default number of votes required to skip a track. Defaults to 3.

- ``pibox/default_playlists``: The URIs of the default playlists to play from when starting a new session. Defaults to `a Spotify playlist of great party songs <https://open.spotify.com/playlist/79inBfAlnfUB7i5kRthmWL?si=e8a5da23f91048c2>`_. Save it to your Spotify library!


Project resources
=================

- `Source code <https://github.com/gavinbannerman/mopidy-pibox>`_
- `Issue tracker <https://github.com/gavinbannerman/mopidy-pibox/issues>`_


Credits
=======

- Original author: `Gavin Bannerman <https://github.com/gavinbannerman>`_
