Skip to content

Custom Snapweb based on the official react project

License

Notifications You must be signed in to change notification settings

jorenn92/Snapweb

Repository files navigation

What is this?

This is an alternate version of the official react branch of SnapWeb, modified to look a bit more modern.

Changes include:

  • drag & drop clients between sources
  • bottom navigation
  • Spacing and other UI improvements

This is created for personal use in conjunction with jorenn92/Snapserver-spotify-airplay to manage multiroom audio in my residence.

You may use this, but i (probably) won't react to bugs / PR's (unless they fix/improve things i find useful)

Original Snapweb documentation

Snapserver is a 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 'REACT_APP_SNAPSERVER_HOST = localhost:1780' > .env.local
  2. Install dependencies
    npm ci
  3. Run local web server and watcher
    npm start

Build for production

  1. Install dependencies: npm ci
  2. Build: npm run build
  3. Copy the created build 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 :)

Setup as WebApp

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

Screenshot

TODO: update me! Snapweb

Contributing

TODO: update me! This web client is the author's first JavaScript/TypeScript project and is rather a proof of concept for the Snapserver's WebSocket API.
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:

  • Missing opus support #8
  • Missing Vorbis support #14
  • Missing toggle to show/hide offline clients #7
  • Missing "About" dialog showing the version number and license #15
  • Missing version number #15

Please consider that one of the design goals is to keep the client small and simple, i.e. to use plain TypeScript/CSS without any frameworks.

About

Custom Snapweb based on the official react project

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages