{"id":26347083,"url":"https://github.com/0hstormy/bnap4000","last_synced_at":"2025-03-16T07:15:39.182Z","repository":{"id":264263999,"uuid":"892871699","full_name":"0hStormy/bnap4000","owner":"0hStormy","description":"A simple music player made in made with true randomness in mind.","archived":false,"fork":false,"pushed_at":"2025-02-16T18:38:20.000Z","size":10308,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T19:29:04.399Z","etag":null,"topics":["libvlc","music","music-player","python","tui","vlc"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0hStormy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-23T00:11:56.000Z","updated_at":"2025-02-16T18:38:23.000Z","dependencies_parsed_at":"2024-11-23T01:19:07.304Z","dependency_job_id":"47eebc94-d713-4608-8327-4abdd5b03457","html_url":"https://github.com/0hStormy/bnap4000","commit_stats":null,"previous_names":["0hstormy/bnap4000"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0hStormy%2Fbnap4000","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0hStormy%2Fbnap4000/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0hStormy%2Fbnap4000/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0hStormy%2Fbnap4000/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0hStormy","download_url":"https://codeload.github.com/0hStormy/bnap4000/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243835946,"owners_count":20355616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["libvlc","music","music-player","python","tui","vlc"],"created_at":"2025-03-16T07:15:38.626Z","updated_at":"2025-03-16T07:15:39.168Z","avatar_url":"https://github.com/0hStormy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![bnap4000](.github/full.svg)\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"GitHub Release\" class=\"badge\" src=\"https://img.shields.io/github/v/release/0hstormy/bnap4000\"\u003e\n    \u003cimg alt=\"GitHub last commit\" class=\"badge\" src=\"https://img.shields.io/github/last-commit/0hstormy/bnap4000\"\u003e\n    \u003cimg alt=\"GitHub contributors\" src=\"https://img.shields.io/github/contributors/0hstormy/bnap4000\"\u003e\n\u003c/p\u003e\n\n---\n\n# Intro\n\nBadass New Audio Player 4000 (bnap4000) is a simple music player made in made with true randomness in mind. Using libVLC as a backend meaning you don't have to worry about if your music will play, all you need to worry about is getting homework done or working on your project.\n\n## Features\n\n* Lightweight\n* Runs in your terminal\n* Great file compatibility\n* Chooses songs randomly\n* Single file playback mode\n* Cross-platform on Linux and Windows (MacOS too if built yourself)\n\n## Demo\n\n![bnap4000](.github/demo.gif)\n\n# Installation\n\nNow that you think that this project is pretty cool, let's install the dang thing!\n\n## Stable\n\n1. Make sure you have VLC installed, you can get it from https://www.videolan.org/vlc/ or through your package manager such as `apt` or `winget`\n2. Download the program from the [releases](https://github.com/0hStormy/bnap4000/releases) tab.\n3. Either run directly or move it to a folder in your PATH such as `/usr/local/bin/`\n4. If you want fancy icons in bnap4000, make sure to install and use a [Nerd Font](https://www.nerdfonts.com/font-downloads) of your choice.\n\n    If you're on Linux make sure to install VLC as a system package so bnap4000 can access libraries!\n\n* Linux has the highest support level since it's what I develop on\n* Windows has moderate support since I have a virtual machine ready for development\n* MacOS has no official support currently but if you can get it to work, good on you!\n\n## Unstable\n\nMake sure you have VLC installed, you can get it from https://www.videolan.org/vlc/ or through your package manager such as `apt` or `winget`. Also make sure you have [Python](https://python.org) with `pip` installed.\nIf you want fancy icons in bnap4000, make sure to install and use a Nerd Font of your choice.\n\n**You'll need Python 3.11 or newer!**\n\nInstall dependencies:\n\nFedora/RedHat\n``` bash\nsudo dnf install pip3 python3 python3-devel gcc patchelf ccache git vlc -y\n```\n\nDebian/Ubuntu\n``` bash\nsudo apt install python3-pip python3 python3-dev gcc patchelf ccache git vlc -y\n```\n\nThen run the following on *nix:\n\n```\ngit clone https://github.com/0hStormy/bnap4000.git\ncd bnap4000\npip3 install -r requirements.txt # pip command may differ between distro and OS.\nsh devinstall.sh /usr/local/bin/\n```\n\nFor Windows:\n\n```\ngit clone https://github.com/0hStormy/bnap4000.git\ncd bnap4000\npip install -r requirements.txt\npy -m nuitka --standalone --onefile main.py # Only runs up to Python 3.12 currently.\n```\n\n# Default Keybinds\n\n* `Z` to skip song\n* `-` to lower volume\n* `=` to make volume higher\n* `X` to restart the current song\n* `L` to toggle looping\n* `S` to open song selection menu (`pa` to play selected album from menu)\n* `Q` to quit\n\n# Credits\n\nThank you to the teams of people who made:\n\n* VideoLan for making [libVLC](https://www.videolan.org/vlc/libvlc.html)\n* oaubert for making [python-vlc](https://pypi.org/project/python-vlc/)\n* tartley for making [Colorama](https://pypi.org/project/colorama/)\n\nWithout these projects, I couldn't have made this!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0hstormy%2Fbnap4000","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0hstormy%2Fbnap4000","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0hstormy%2Fbnap4000/lists"}