Skip to content

Latest commit

 

History

History
73 lines (44 loc) · 2.86 KB

README.md

File metadata and controls

73 lines (44 loc) · 2.86 KB
Raw

soundseeder Speaker UI

soundseeder is a wireless audio system application. Music can be played simultaneously by several devices controlled by the soundseeder application. One device is the streaming master, all other devices are speakers.

Non-Android devices are always speakers. soundseeder itself provide a Java application without any user interface for this purpose. This application uses the provided JAR and adds a simple user interface.

Plaging view

playing view

Disconnected view

disconnected view

Configuration view

config view

The current implementation is in alpha status. It works, but under the hood there remains some work.

Requirements

To run the soundseeder Speaker UI your device needs to comply with the requirements:

  • installed Oracle Java 1.8
  • attached to a Network (W-LAN or LAN)
  • Soundcard

Build sources

soundseeder Speaker UI is a Java application using Maven as buildtool. To compile the sources you need:

  • installed Oracle Java JDK 1.8+
  • installed and configured Apache Maven 3+
  • downloaded sources
  • installed soundseederspeaker.jar in local Maven repository

Install soundseederspeaker.jar locally in Maven repository

Open a console and navigate to project's root folder. Run

mvn install:install-file -Dfile=lib/SpeakerSE_v0.5.0.jar -DgroupId=com.soundseeder -DartifactId=soundseeder-speaker -Dversion=0.5.0 -Dpackaging=jar

to install the soundseederspeaker.jar locally in your Maven repository.

Compile the sources

Open a console and navigate to the root folder of soundseeder-speaker-ui and run

mvn clean package

You can add the option "-DskipTests" if you want to skip compiling the tests and building the test artifacts.

Sources are compiled and a JAR (soundseeder-speaker-ui-.jar) containing a runnable application is created in the target folder.

Custom coding

Coding can be done in your favorite Java IDE. As this application uses Projekt Lombok for generated Getters/Setters etc. it needs to be installed in your IDE, otherwise you get compilation errors.

Installation / startup

Compile the sources and execute the previously generated soundseeder-speaker-ui.jar on the device you want to use as speaker using.

java -jar soundseeder-speaker-ui.jar

After that use a browser of your choice and open http://localhost:8080 (in case you started the soundseeder Speaker UI on your computer).

Installation as a Linux service

The soundseeder Speaker UI is a Spring-Boot application. To install the application as a Linux / Windows service, just follow the instruction in the Spring-Boot documentation.