Metadata-Version: 2.1
Name: playsongs
Version: 2021.1.0.5
Summary: Play MP# from a directory.
Home-page: https://github.com/fer1035/pypi-playsongs
License: GPL-2.0-only
Keywords: music,MP3
Author: Ahmad Ferdaus Abd Razak
Author-email: ahmad.ferdaus.abd.razak@ni.com
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: playsound (>=1.2.2,<2.0.0)
Project-URL: Repository, https://github.com/fer1035/pypi-playsongs
Description-Content-Type: text/x-rst

==============
**PlaySongs**
==============

Overview
--------

Play MP3 from a specified directory.

Prerequisites
-------------

- *playsound* module (installed as a dependency)
- **CAVEAT**: Due to *playsound* limitations, directory and filenames with spaces are not allowed.

Required (Positional) Arguments
-------------------------------

- Position 1: /path/to/mp3/files

Optional (Keyword) Arguments
----------------------------

- repeat
    - Description: Number of times to repeat the whole collection.
    - Type: Integer
    - Default: 0
- shuffle
    - Description: Select whether to shuffle the list of songs being played.
    - Type: Boolean
    - Default: False

Usage
-----

Installation:

.. code-block:: BASH

   pip3 install playsongs
   # or
   python3 -m pip install playsongs

In Python3:

.. code-block:: BASH

   from playsongs.playsongs import PlaySongs
   PlaySongs('/home/username/Music', repeat = 10000000, shuffle = True)

In BASH:

.. code-block:: BASH

   python3 -c "from playsongs.playsongs import PlaySongs; PlaySongs('/home/username/Music', repeat = 10000000, shuffle = True)"

Changelog
---------

2021.1.0.5

- Updated code to return instead of exit in case of exceptions.

2021.1.0.4

- Updated typo in README (this file).
- No code change.

2021.1.0.3

- Removed system exit at the end of the playlist so it won't kill Python runtime.
- CTRL+C will still kill Python runtime.

2021.1.0.1

- Initial release.

*Current version: 2021.1.0.5*

