# m3u maker
## Installation
This script doesn't have any dependencies except from python, so install python3.6+ before.
python2 is not supported
### with pip
```bash
pip install m3u-maker
m3u-maker ~/Music > out.m3u
```
#### available aliases
the best way to run is directly with: `python -m m3u_maker`
but the following aliases are available `m3u-maker`, `mkm3u`, `mkm3u8`
### manual
```bash
git clone https://github.com/CastixGitHub/m3u_maker
cd m3u_maker
python m3u_maker.py ~/Music > out.m3u
```
## Help menu
```
usage: 'm3u_maker [-h] [sources [sources ...]]
Finds music files by extension (flac, ogg, oga, wav, mp3,
aiff, aif, loss, m4a, aac, alac, mogg, opus. webm, mp4, wma, mpc)
inside a folders and it's subdirectories, makes a m3u file
without metadata
positional arguments:
sources
Source directories that contains the music
(subdirectories are included).
We suggest to use an absolute path for better
compatibility with players.
If you want to use relative paths remember that them
are relative to the location of the output m3u file.
Defaults to the directory where the script is called
from (`pwd`).
optional arguments:
-h, --help show this help message and exit
Example Usage:
python m3u_maker.py ~/Music > out.m3u
Example with random order without duplicates:
python m3u_maker.py ~/Music | uniq | shuf > out.m3u
```
## Testing & Development
after activating a virtualenv:
install the project with
```bash
pip install -e '.[test]'
```
run the tests with
```bash
pytest --cov=.
```
### release a new version on pypi
1. update the version number in setup.py
1. clean the old built `rm -rf dist`
1. build tarball and wheel with `python setup.py sdist bdist_wheel`
1. install twine `pip install twine`
1. upload with `twine upload dist/m3u_maker-*`
Raw data
{
"_id": null,
"home_page": "https://github.com/CastixGitHub/m3u_maker",
"name": "m3u-maker",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "m3u m3u8 playlist",
"author": "Castix",
"author_email": "castix@autistici.org",
"download_url": "https://files.pythonhosted.org/packages/66/6a/4734e15da7730e9b40417c0a5c4273b3abdb2af6da986c89fa67f6d9bddb/m3u_maker-0.1.4.tar.gz",
"platform": null,
"description": "# m3u maker\n\n## Installation\nThis script doesn't have any dependencies except from python, so install python3.6+ before.\npython2 is not supported\n\n### with pip\n```bash\npip install m3u-maker\nm3u-maker ~/Music > out.m3u\n```\n\n#### available aliases\nthe best way to run is directly with: `python -m m3u_maker`\n\nbut the following aliases are available `m3u-maker`, `mkm3u`, `mkm3u8`\n\n### manual\n```bash\ngit clone https://github.com/CastixGitHub/m3u_maker\ncd m3u_maker\npython m3u_maker.py ~/Music > out.m3u\n```\n\n## Help menu\n```\nusage: 'm3u_maker [-h] [sources [sources ...]]\n\n Finds music files by extension (flac, ogg, oga, wav, mp3,\n aiff, aif, loss, m4a, aac, alac, mogg, opus. webm, mp4, wma, mpc)\n inside a folders and it's subdirectories, makes a m3u file\n without metadata\n \n\npositional arguments:\n sources \n Source directories that contains the music\n (subdirectories are included).\n We suggest to use an absolute path for better\n compatibility with players.\n If you want to use relative paths remember that them\n are relative to the location of the output m3u file.\n Defaults to the directory where the script is called\n from (`pwd`).\n\noptional arguments:\n -h, --help show this help message and exit\n\n Example Usage:\n python m3u_maker.py ~/Music > out.m3u\n Example with random order without duplicates:\n python m3u_maker.py ~/Music | uniq | shuf > out.m3u\n```\n## Testing & Development\n\nafter activating a virtualenv:\n\ninstall the project with\n```bash\npip install -e '.[test]'\n```\nrun the tests with\n```bash\npytest --cov=.\n```\n\n### release a new version on pypi\n\n1. update the version number in setup.py\n1. clean the old built `rm -rf dist`\n1. build tarball and wheel with `python setup.py sdist bdist_wheel`\n1. install twine `pip install twine`\n1. upload with `twine upload dist/m3u_maker-*`\n",
"bugtrack_url": null,
"license": "",
"summary": "finds music files in directory and create a m3u playlist",
"version": "0.1.4",
"split_keywords": [
"m3u",
"m3u8",
"playlist"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8f6dbd6c78343cf727d5f9bf549f1ca668518db3b882e2f81638a9b97605b509",
"md5": "e528e6565d341ed0062a81a524e55167",
"sha256": "ac4a10f7ab0cd7f25d936acda27b0539564827a06ec4b75c3cfbe244fb2729eb"
},
"downloads": -1,
"filename": "m3u_maker-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e528e6565d341ed0062a81a524e55167",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 16829,
"upload_time": "2023-01-06T17:26:46",
"upload_time_iso_8601": "2023-01-06T17:26:46.594876Z",
"url": "https://files.pythonhosted.org/packages/8f/6d/bd6c78343cf727d5f9bf549f1ca668518db3b882e2f81638a9b97605b509/m3u_maker-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "666a4734e15da7730e9b40417c0a5c4273b3abdb2af6da986c89fa67f6d9bddb",
"md5": "e5e11a8d20581f0edb0c0ac3cf1397b5",
"sha256": "8d1ac438645af1c4edc33131f0c803611910cdc1cee900ce726ac974bd8fea9f"
},
"downloads": -1,
"filename": "m3u_maker-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "e5e11a8d20581f0edb0c0ac3cf1397b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 16064,
"upload_time": "2023-01-06T17:26:48",
"upload_time_iso_8601": "2023-01-06T17:26:48.329692Z",
"url": "https://files.pythonhosted.org/packages/66/6a/4734e15da7730e9b40417c0a5c4273b3abdb2af6da986c89fa67f6d9bddb/m3u_maker-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-06 17:26:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "CastixGitHub",
"github_project": "m3u_maker",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"lcname": "m3u-maker"
}