Skip to content

Commit

Permalink
Modified readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Carlos Pérez committed Jul 18, 2022
1 parent 3dd5977 commit e6af3bf
Show file tree
Hide file tree
Showing 6 changed files with 55 additions and 14 deletions.
Binary file added Assets/screenshot.cli.1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Assets/screenshot.cli.2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Assets/screenshot.cli.3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Assets/screenshot.cli.4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Assets/screenshot.cli.5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
69 changes: 55 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,41 @@
# Soniclair
# Soniclair.NET

<p align="middle">
<img src="./logo.svg">
</p>

## An album-centered subsonic client for Xbox and the Terminal

## An album-centered subsonic client for Xbox

SonicLair is a minimal, mobile-ready, album-centered music client for subsonic compatible music servers built using UWP and designed to run on Xbox.
SonicLair.NET is a minimal, album-centered music client for subsonic compatible music servers built using .net Core 6 and UWP, designed to run on Xbox and the terminal (Windows, Linux and macOS).

## Features

- Connect to any subsonic-compatible music server. Tested on Navidrome.
- Album-centered music playing: if you start playing a song, the album becomes your playlist.
- Start a radio based on any song on your library.
- Search throughout your entire music library.
- Connect your Xbox to your server using SonicLair on [your phone running Android](https://github.com/thelinkin3000/SonicLair) and a QR Code. (All the communications are made within the LAN, no third-party servers involved)
- Jukebox Mode! Run an instance of Soniclair in an Xbox and control it from another instance running on Android.
- Connect your Xbox or terminal to your server using SonicLair on [your phone running Android](https://github.com/thelinkin3000/SonicLair) and a QR Code. (All the communications are made within the LAN, no third-party servers involved)
- Jukebox Mode! Run an instance of Soniclair in an Xbox or any computer with a terminal and control it from another instance running on Android.

## Screenshots for Xbox

## Screenshots
<p align="middle">
<img src="./Assets/screenshot1.png" width="70%">
<img src="./Assets/screenshot2.png" width="70%">
<img src="./Assets/screenshot3.png" width="70%">
<img src="./Assets/screenshot4.png" width="70%">
</p>

## Screenshots for the Terminal

<p align="middle">
<img src="./Assets/screenshot.cli.1.png" width="70%">
<img src="./Assets/screenshot.cli.2.png" width="70%">
<img src="./Assets/screenshot.cli.3.png" width="70%">
<img src="./Assets/screenshot.cli.4.png" width="70%">
<img src="./Assets/screenshot.cli.5.png" width="70%">
</p>

## Installation and Usage

### Xbox Retail Mode
Expand All @@ -37,13 +46,44 @@ SonicLair is a minimal, mobile-ready, album-centered music client for subsonic c

I'm working on getting a pipeline on github actions to get signed bundles for installing on Xbox via the Device Portal. Soon!

### Terminal

The terminal version is an (almost) self contained executable. You can grab the version for your operating system from the releases page. Within the compressed file there is the excutable and (if applicable) the libvlc libraries needed for the audio backend to work. Please keep the directory structure as is.

### Linux caveats

For linux, the app will search for the relevant libvlc files from your installation.

For Ubuntu and Debian

sudo apt update
sudo apt upgrade (if you haven't done it in a while)
sudo apt install libvlc-dev libx11-dev

And then you can try the app. If it complains that it can't instantiate libvlc try

sudo apt install vlc

More info about this [here](https://github.com/videolan/libvlcsharp/blob/3.x/docs/linux-setup.md)

## Projects leveraged here

Soniclair is built upon

### Xbox

- [WinUI2]
- [WindowsCommunityToolkit] (used for a couple animations)

### Terminal

- [Terminal.GUI]

### Common

- [VLC] (as an audio backend)
- [Watson Websocket]
- [QR Coder]
- [Dillinger] (used to write this README)

## Contribute
Expand All @@ -56,10 +96,11 @@ Soon, though.
MIT, see LICENSE for more info.
But basically, you can do whatever you want with this code.

[//]: # (These are reference links used in the body of this note and get stripped out when the markdown processor does its job. There is no need to format nicely because it shouldn't be seen. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax)

[WinUI2]: <https://github.com/microsoft/microsoft-ui-xaml>
[WindowsCommunityToolkit]: <https://github.com/CommunityToolkit/WindowsCommunityToolkit>
[VLC]: <https://www.videolan.org/>
[Dillinger]: <https://github.com/joemccann/dillinger>

[//]: # "These are reference links used in the body of this note and get stripped out when the markdown processor does its job. There is no need to format nicely because it shouldn't be seen. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax"
[winui2]: https://github.com/microsoft/microsoft-ui-xaml
[windowscommunitytoolkit]: https://github.com/CommunityToolkit/WindowsCommunityToolkit
[vlc]: https://www.videolan.org/
[dillinger]: https://github.com/joemccann/dillinger
[terminal.gui]: https://github.com/migueldeicaza/gui.cs
[watson websocket]: https://github.com/jchristn/WatsonWebsocket
[qr coder]: https://github.com/codebude/QRCoder

0 comments on commit e6af3bf

Please sign in to comment.