Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,14 +59,16 @@ bash build.sh

This creates `Sonance3.wgt` (~200KB) which you can install via Jellyfin2Samsung.

If you are using Nix, you can make use of the provided `shell.nix` with `nix-shell` to have a shell environment with the needed dependencies.

## Setup

1. Launch Sonance on your TV
2. Enter your server address (e.g. `192.168.0.1`) and port (e.g. `4533`)
3. Enter your username and password
4. You're in — start browsing and playing

Sonance communicates with your server via the Subsonic REST API.
Sonance communicates with your server via the Subsonic REST API.

## Remote Controls

Expand Down Expand Up @@ -123,7 +125,7 @@ python3 -m http.server 8080
# Open http://localhost:8080 in your browser
```

The app runs in any modern browser for development. AVPlay features (hardware decoding, media keys) only work on the TV — the browser uses HTML5 Audio as a fallback.
The app runs in any modern browser for development. AVPlay features (hardware decoding, media keys) only work on the TV — the browser uses HTML5 Audio as a fallback.


### Project structure
Expand Down Expand Up @@ -175,7 +177,7 @@ This app targets Samsung TVs from 2019, which run Chromium 63. Key limitations t

## Licence

GNU GPL v3. You are free to use this however you want as long as it stays free and open-source. You cannot commercialise this or close source any version of it.
GNU GPL v3. You are free to use this however you want as long as it stays free and open-source. You cannot commercialise this or close source any version of it.
You cannot use this to train AI.

## Acknowledgements
Expand Down
2 changes: 1 addition & 1 deletion build.sh
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#!/bin/bash
#!/usr/bin/env bash
# Sonance — Build Script
# Packages the app into Sonance3.wgt for Samsung Tizen TV deployment.
#
Expand Down
18 changes: 18 additions & 0 deletions shell.nix
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{ pkgs ? import <nixpkgs> {} }:

pkgs.mkShell {
buildInputs = with pkgs; [
nodejs # provides node, npm, npx
zip
unzip
gawk
gnugrep
coreutils # wc, du, etc.
];

shellHook = ''
echo "Sonance3 dev shell ready."
echo "Run: ./build.sh # build production .wgt"
echo " ./build.sh --dev # restore dev mode"
'';
}