Metadata-Version: 2.4
Name: Mopidy-Pibox
Version: 3.0.1
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.50
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"
Dynamic: license-file

.. 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
=============

**Note:** In order to understand if people are using Pibox, `GoatCounter <https://www.goatcounter.com>`_ is used to track basic usage. It does not store any personal data. If you do not want analytics to be collected, you can disable it by setting the ``disable_analytics`` config option to ``true`` in your Mopidy config file.

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
    disable_analytics = false

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!

- ``pibox/disable_analytics``: Stops `GoatCounter <https://www.goatcounter.com>`_ analytics from being included in the Pibox web app. Defaults to ``false``.


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>`_
