# PQMusic
[https://github.com/son-link/PQMusic](https://github.com/son-link/PQMusic)
PQMusic is a minimalist and easy to use audio player for download and use.
You can play your local files, from a direct url or streaming (for example a online radio) and import/export playlists on M3U format. Also you can play some music trackers files (.it, .mod, .s3m and .xm)
Adding files from Open with on your file manager
Drag and drop files to PQMusic's window:
<video controls style="max-width: 720px">
<source src="pqmusic-drag-drop.mp4" />
</video>
Only available for Linux.
Licensed under GNU/GPL3 or higher.
## Install
### From source code:
* Clone the repo, download the zip under Code -> Download ZIP or download the last release.
* Open a terminal and go to the project folder.
* Install the dependencies:
* **From PIP**: `pip install -r requirements.txt` *use the --user parameter if you want to install the dependencies at your user level*
* **Debian/Ubuntu/Mint/MX Linux**:
* apt: `apt install python3-pyqt5 python3-pyqt5.qtmultimedia libqt5multimedia5 libqt5multimedia5-plugins qtgstreamer-plugins-qt5 python3-mutagen python3-magic python3-requests`
* **Arch Linux/Manjaro**:
* pacman: `python-pip python-mutagen python-pyqt5 qt5-multimedia python-mutagen python-magic python-requests`
* Copy the icon and desktop file:
* All users:
* `install -m 644 bin/io.sonlink.pqmusic.desktop /usr/share/applications`
* `install -m 644 bin/io.sonlink.pqmusic.svg /usr/share/icons/pqmusic.svg`
* Current user:
* `cp bin/io.sonlink.pqmusic.desktop ~/.local/share/applications`
* `cp bin/io.sonlink.pqmusic.svg ~/.icons/pqmusic.svg`
### From Pypi:
`pip install PQMusic`
### AUR:
If you use Arch Linux, Manjaro, or other Arch Linux base distributions, you can install the official package from [AUR](https://aur.archlinux.org/packages/pqmusic)
For example: `yay -S pqmusic`
### Executables:
You can download a **AppImage** for **GNU/Linux** on [releases page](https://github.com/son-link/PQMusic/releases)
### Command line options:
* `--custom-theme`: Use the application's theme instead of using the environment or default Qt theme
* `-f | --files <files and/or dirs>`: Add files and/or directories for direct playback at startup
### Shortcuts:
* Ctrl+O: Add files
* Ctrl+D: Add dir
* Ctrl+U: Add URL
* Ctrl+P: Open playlist
* Ctrl+C: Open config dialog
* Ctrl+Q: Quit
## Other credits:
* Lüv icons theme: https://github.com/Nitrux/luv-icon-theme
* Open Sans font: https://fonts.google.com/specimen/Open+Sans
* [QssStylesheetEditor](https://github.com/hustlei/QssStylesheetEditor) for make the app theme
* Musical note use in the app icon: https://openclipart.org/detail/110599/musical-note-2-dennis-b-01r
Raw data
{
"_id": null,
"home_page": "https://github.com/son-link/PQMusic",
"name": "pqmusic",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "music,audio,player",
"author": "Alfonso Saavedra 'Son Link'",
"author_email": "sonlink.dourden@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a0/7f/d856294bb481afc091ccf0c73dbb8e92a0e4732ce2b40bfd43692ce7727a/pqmusic-1.3.0.tar.gz",
"platform": null,
"description": "# PQMusic\n\n\n\n\n\n\n\n\n[https://github.com/son-link/PQMusic](https://github.com/son-link/PQMusic)\n\n\n\nPQMusic is a minimalist and easy to use audio player for download and use.\n\nYou can play your local files, from a direct url or streaming (for example a online radio) and import/export playlists on M3U format. Also you can play some music trackers files (.it, .mod, .s3m and .xm)\n\nAdding files from Open with on your file manager\n\n\nDrag and drop files to PQMusic's window:\n\n<video controls style=\"max-width: 720px\">\n <source src=\"pqmusic-drag-drop.mp4\" />\n</video>\n\nOnly available for Linux.\n\nLicensed under GNU/GPL3 or higher.\n\n## Install\n\n### From source code:\n\n* Clone the repo, download the zip under Code -> Download ZIP or download the last release.\n* Open a terminal and go to the project folder.\n* Install the dependencies:\n * **From PIP**: `pip install -r requirements.txt` *use the --user parameter if you want to install the dependencies at your user level*\n * **Debian/Ubuntu/Mint/MX Linux**:\n * apt: `apt install python3-pyqt5 python3-pyqt5.qtmultimedia libqt5multimedia5 libqt5multimedia5-plugins qtgstreamer-plugins-qt5 python3-mutagen python3-magic python3-requests`\n * **Arch Linux/Manjaro**:\n * pacman: `python-pip python-mutagen python-pyqt5 qt5-multimedia python-mutagen python-magic python-requests`\n\n * Copy the icon and desktop file:\n * All users:\n * `install -m 644 bin/io.sonlink.pqmusic.desktop /usr/share/applications`\n \t * `install -m 644 bin/io.sonlink.pqmusic.svg /usr/share/icons/pqmusic.svg`\n \t* Current user:\n \t * `cp bin/io.sonlink.pqmusic.desktop ~/.local/share/applications`\n \t * `cp bin/io.sonlink.pqmusic.svg ~/.icons/pqmusic.svg`\n\n### From Pypi:\n\n`pip install PQMusic`\n\n### AUR:\n\nIf you use Arch Linux, Manjaro, or other Arch Linux base distributions, you can install the official package from [AUR](https://aur.archlinux.org/packages/pqmusic)\n\nFor example: `yay -S pqmusic`\n\n### Executables:\n\nYou can download a **AppImage** for **GNU/Linux** on [releases page](https://github.com/son-link/PQMusic/releases)\n\n### Command line options:\n\n* `--custom-theme`: Use the application's theme instead of using the environment or default Qt theme\n* `-f | --files <files and/or dirs>`: Add files and/or directories for direct playback at startup\n\n### Shortcuts:\n\n* Ctrl+O: Add files\n* Ctrl+D: Add dir\n* Ctrl+U: Add URL\n* Ctrl+P: Open playlist\n* Ctrl+C: Open config dialog\n* Ctrl+Q: Quit\n\n## Other credits:\n\n* L\u00fcv icons theme: https://github.com/Nitrux/luv-icon-theme\n\n* Open Sans font: https://fonts.google.com/specimen/Open+Sans\n\n* [QssStylesheetEditor](https://github.com/hustlei/QssStylesheetEditor) for make the app theme\n\n* Musical note use in the app icon: https://openclipart.org/detail/110599/musical-note-2-dennis-b-01r\n",
"bugtrack_url": null,
"license": "GPL 3.0",
"summary": "A minimal music player.",
"version": "1.3.0",
"project_urls": {
"Download": "https://github.com/son-link/PQMusic/archive/refs/tags/v.1.3.0.tar.gz",
"Homepage": "https://github.com/son-link/PQMusic"
},
"split_keywords": [
"music",
"audio",
"player"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a07fd856294bb481afc091ccf0c73dbb8e92a0e4732ce2b40bfd43692ce7727a",
"md5": "991ee977fd58881a5daa0281f05fa4ca",
"sha256": "73c1477288b98192d5638003e6772eeb4b36c69590a705426a7014642db7dd17"
},
"downloads": -1,
"filename": "pqmusic-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "991ee977fd58881a5daa0281f05fa4ca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1541466,
"upload_time": "2023-05-15T20:57:28",
"upload_time_iso_8601": "2023-05-15T20:57:28.347808Z",
"url": "https://files.pythonhosted.org/packages/a0/7f/d856294bb481afc091ccf0c73dbb8e92a0e4732ce2b40bfd43692ce7727a/pqmusic-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-15 20:57:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "son-link",
"github_project": "PQMusic",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pyqt5",
"specs": []
},
{
"name": "mutagen",
"specs": []
},
{
"name": "python-magic",
"specs": []
},
{
"name": "psutil",
"specs": []
},
{
"name": "requests",
"specs": []
}
],
"lcname": "pqmusic"
}
JSON
