https://github.com/wewatchwall/stark-player
A synchronized mp3 player drone for audio in browsers.
https://github.com/wewatchwall/stark-player
browser cloud drones iot javascript music typescript
Last synced: about 2 months ago
JSON representation
A synchronized mp3 player drone for audio in browsers.
- Host: GitHub
- URL: https://github.com/wewatchwall/stark-player
- Owner: WeWatchWall
- License: mit
- Created: 2021-09-05T08:15:17.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-10-11T07:37:04.000Z (over 4 years ago)
- Last Synced: 2025-03-18T14:11:26.514Z (over 1 year ago)
- Topics: browser, cloud, drones, iot, javascript, music, typescript
- Language: CSS
- Homepage: https://www.npmjs.com/package/stark-player
- Size: 28.3 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mp3 Player Drone Running on the Stark Orchestrator in Browsers
[](https://github.com/WeWatchWall/stark-player/actions?query=workflow%3A%22Lint+and+test%22)
[](https://www.npmjs.com/package/stark-player)
UI package for playing .PLS playlists of MP3 files, running in the browser, on the Stark Orchestrator, built with Vue.js.
Demo: [WWWall Utility](https://wewatchwall.github.io/stark-player/)
## Getting Started
The [Stark-Orchestrator](https://github.com/WeWatchWall/stark-orchestrator) project that runs the Core of the system needs to have been initialized for the server to respond to the browsng endpoint http://LAN_URL:STARK_PORT.
Then, the following commands will use $STARK_HOME/.env to deploy the player package to the configured user:
1. First, navigate to the packages folder of the Stark-Orchestrator project.
```bash
cd $STARK_HOME/packages
```
2. Clone or download the Stark-Player project.
```bash
gh repo clone WeWatchWall/stark-player
```
3. Run the deployment script.
```bash
cd stark-player/bin
watch-deploy.cmd
```
4. This script will watch $STARK_HOME/packages/stark-player/dist until it is cancelled. Your prompt will return to $STARK_HOME.
## Usage
First, use the left menu to navigate to the Control panel.
You can upload a .zip file containing:
1. A .PLS file with Path, Title, Length for each track on the playlist.
2. An .MP3 file for each entry in the .PLS file.
Two example copyright-free playlists are included in the /example_playlists folder.
[This link describes how to work with .PLS playlists.](https://www.thewindowsclub.com/what-is-a-pls-file)
For best results, keep all the files in the root level of the .zip archive.
Once the playlist is loaded, central playback controls will appear below the file selector input. Press play.
Then, navigate to the Play panel. The user must press play at least once on the audio element on the Play panel to hear the playback on each browser window.
Sync can be controlled per browser instance.