Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/romeovs/nts-desktop
An unofficial Desktop app for playing NTS Live streams and archived shows
https://github.com/romeovs/nts-desktop
Last synced: 11 days ago
JSON representation
An unofficial Desktop app for playing NTS Live streams and archived shows
- Host: GitHub
- URL: https://github.com/romeovs/nts-desktop
- Owner: romeovs
- License: mit
- Created: 2021-05-06T08:11:00.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-06T23:25:11.000Z (14 days ago)
- Last Synced: 2024-11-07T00:29:25.878Z (14 days ago)
- Language: TypeScript
- Homepage:
- Size: 61.3 MB
- Stars: 12
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# NTS Desktop
[](https://github.com/romeovs/nts-desktop/actions/workflows/ci-cd.yml)
An unofficial desktop app for NTS built in Electron.
## Usage
- Click the NTS logo in the menubar to open the player.
- Use the left and right buttons on the player to navigate between channels. You
can also use the arrow keys.
- Click the play/stop button on the live streams to play them. Spacebar works
too.
- On the live streams click the tracklist button in to top right corner to open
the live tracklist in the browser. (This will only work if you are an [NTS
Supporter](https://www.nts.live/supporters)).
- Drop the link from the browser to an archive show on the menubar icon to play
it, `.webloc` files work too.
- On the archive screen, you can scroll down to reveal the controls and
tracklist.
- Click on a tracklist item to copy the information.
- Press `⌘Q` when the window is open.
- You can refresh the app with `⌘R`
- `ctrl + N` will open NTS Desktop
- Pressing `T` when the window is open will open the tracklist
- Pressing `C` when the window is open will open the chat window for that
channel
- Pressing `1` or `2` when the window is open will start playing the
corresponding channel
- Pressing `-` and `+` will control the volume of the player
## Installation
Go to the [Releases Page](https://github.com/romeovs/nts-desktop/releases) and
fetch the `.dmg` file from the latest release.
Open the disk image and drag the `NTS Desktop` app to `Applications` and open
it.
The first time you open the app, it will show an erro because the app isn't
signed. I do not have a Mac Developer license.
To open the app anyway, you can:
```
System Preferences > Security & Privacy > General > Open Anyway
```
I have only tested this app on macOS, so I can't guarantee it works on Linux or
Windows. If people want to help me port it over, shoot me a message, PR's are welcome!
## Local Development
The project is structured as follows:
```
./
src/
main.ts # The electron main file
preload.js # A setup file for the browser context
client/ # The electron renderer files
main.ts
...
```
To start the app in developement mode, run:
```
make dev
```
You can now start editing the renderer files, changes will automatically
take effect on save.
Note that changes to the main process (`src/main.ts` and `src/preload.js`)
require a restart to take effect.
To build the application run:
```
make build app
```
The app will now be in `bundle/mac-universal/NTS Desktop.app`.
## Acknowledgement
The main idea for the app came from the excellent
[nts-desktop-app](https://github.com/tedigc/nts-desktop-app), the implementation
of which is way simpler and more elegant, but lacks some of the features I
wanted.