search

badaix / snapweb

Web interface for Snapcast
GNU General Public License v3.0
86 stars 31 forks source link
snapcast typescript webapp webclient webinterface

readme

Snapweb

Web client for Snapcast, optimized for mobile devices, with the look and feel of Snapdroid

Develop

  1. Add your snapserver host as a local environment var 
    echo 'VITE_APP_SNAPSERVER_HOST = localhost:1780' > .env.local
  2. Install dependencies 
    npm ci
  3. Run local web server and watcher 
    npm run dev

Build for production

  1. Install dependencies: npm ci
  2. Build: npm run build
  3. Copy the created dist directory to some path on your snapserver host and let the [http] doc_root in your snapserver.conf point to it
  4. Restart snapserver and navigate with a browser to http://<snapserver host>:1780
  5. Enjoy :)

Prebuilt versions can be downloaded as zip archive or debian package in Releases.

Setup as WebApp

On Android open http://<snapserver host>:1780 in Chrome and select in the menu Add to homescreen

Screenshot

Screenshot is taken on a Pixel 7 emulation in Chrome DevTools

Snapweb-Dark Snapweb-Light

Contributing

Since my time and my web development skills are limited, pull requests are highly appreciated. Please check the list of open issues.\ Branch from the develop branch and ensure it is up to date with the current develop branch before submitting your pull request.

High prio issues: