Skip to content

Commit

Permalink
docs: minor edits
Browse files Browse the repository at this point in the history
  • Loading branch information
bhj committed May 17, 2022
1 parent a215943 commit 2242320
Show file tree
Hide file tree
Showing 3 changed files with 34 additions and 40 deletions.
6 changes: 2 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

### New

- **Name**: Karaoke Forever is now Karaoke Eternal
- **(app)** User management interface
- **(app)** "Make user's next" button for upcoming songs
- **(app)** "Re-queue" button for played songs
Expand All @@ -13,7 +14,6 @@
- **(server)** Custom database file path support (see `--data` CLI option)
- **(server)** Session key can be rotated on startup (see `--rotateKey` CLI option)
- **(server)** All CLI options now have equivalent environment variables
- **(server)** PUID and PGID environment variable support

### Changed

Expand All @@ -33,9 +33,7 @@

### Sponsors

Massive thanks to this release's sponsors: [fulldecent](https://github.com/fulldecent), [vze22jjw](https://github.com/vze22jjw)

If you have fun with it, consider [sponsoring](https://github.com/sponsors/bhj) as we roll down [the road to v1.0](https://github.com/bhj/KaraokeEternal/issues/13).
Massive thanks to this release's sponsors: [fulldecent](https://github.com/fulldecent), [vze22jjw](https://github.com/vze22jjw). If you have fun with it, please consider [sponsoring](https://www.karaoke-eternal.com/sponsor).

### New

Expand Down
66 changes: 31 additions & 35 deletions docs/content/docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,31 +18,6 @@ resources:
galleryOrder: 5
---

## Quick Start

1. Install and run [Karaoke Eternal Server](#karaoke-eternal-server) on the system that will serve the app and media on your local network.

2. Browse to the [app](#karaoke-eternal-the-app) at the **server URL**. You can copy the URL or open it in your default browser using the Karaoke Eternal Server menu bar or tray icon in macOS or Windows.

<aside class="info">
{{% icon-info %}}
<p>Since the app is designed for mobile, use your phone for the best experience.</p>
</aside>

3. Create your **admin** account at the welcome page.

4. In the Preferences panel, tap Media Folders and add your [supported media](#media-files).

5. Once the media scanner finishes, head to the [library](#library) and add some songs by tapping an artist, then tapping a song title. A glowing song means it's upcoming in the queue.

6. Now we just need a [player](#player). On the system that will output the room's audio/video, browse to the **server URL**, sign in with your admin account, and tap the **Start Player** link at the top. If you don't see a link, your current browser doesn't support fullscreen mode, but you can still navigate to `/player`.

7. Playback and display controls will appear on all your devices now that there's a player in the room. The current singer sees these during their turn; admins always see these.

Congratulations, you are now ready to press play and party!

<hr>

## Karaoke Eternal (the app)

Karaoke Eternal is a modern mobile browser app that lets everyone join without having to install anything on their phones. It's built for touch, but a mouse is supported in desktop browsers (click and drag to emulate swipe gestures).
Expand Down Expand Up @@ -143,11 +118,6 @@ Once a player is in the room, playback and display controls will appear. These a

The server hosts the app and your media files, and can run on relatively minimal hardware (Raspberry Pi 3B+). Note that [players](#player) don't need to run on the same system as the server.

<aside class="info">
{{% icon-info %}}
<p>The server chooses a random port at startup unless <a href="#cli--env">otherwise specified</a>.</p>
</aside>

### Installation

#### macOS or Windows
Expand All @@ -164,6 +134,12 @@ The server hosts the app and your media files, and can run on relatively minimal
<p>These packages are not currently signed. On macOS, <strong>do not</strong> disable Gatekeeper; simply right-click <code>Karaoke Eternal Server.app</code> in your Applications folder and choose Open. On Windows, click More Info and then Run Anyway.</p>
</aside>

<aside class="info">
{{% icon-info %}}
<p>The server chooses a random port at startup unless <a href="#cli--env">otherwise specified</a>.</p>
</aside>

See [Quick Start](#quick-start) if you're new to Karaoke Eternal.

#### Docker (Synology)

Expand Down Expand Up @@ -234,11 +210,6 @@ Karaoke Eternal is available as an `npm` package for systems running [Node.js](h
$ npm i -g karaoke-eternal
{{< /highlight >}}

<aside class="info">
{{% icon-info %}}
<p>Depending on availability of pre-built modules (specifically SQLite and bcrypt) for your architecture, compilation tools may need to be present (see the requirements for <a href="https://github.com/nodejs/node-gyp#installation">node-gyp</a>)</p>
</aside>

2. Start the server

{{< highlight shell >}}
Expand Down Expand Up @@ -368,6 +339,31 @@ The default locations for the database (`database.sqlite3`), web server log (`se

<hr>

## Quick Start

1. Install and run [Karaoke Eternal Server](#karaoke-eternal-server) on the system that will serve the app and media on your local network.

2. Browse to the [app](#karaoke-eternal-the-app) at the **server URL**. You can copy the URL or open it in your default browser using the Karaoke Eternal Server menu bar or tray icon in macOS or Windows.

<aside class="info">
{{% icon-info %}}
<p>Since the app is designed for mobile, use your phone for the best experience.</p>
</aside>

3. Create your **admin** account at the welcome page.

4. In the Preferences panel, tap Media Folders and add your [supported media](#media-files).

5. Once the media scanner finishes, head to the [library](#library) and add some songs by tapping an artist, then tapping a song title. A glowing song means it's upcoming in the queue.

6. Now we just need a [player](#player). On the system that will output the room's audio/video, browse to the **server URL**, sign in with your admin account, and tap the **Start Player** link at the top. If you don't see a link, your current browser doesn't support fullscreen mode, but you can still navigate to `/player`.

7. Playback and display controls will appear on all your devices now that there's a player in the room. The current singer sees these during their turn; admins always see these.

Congratulations, you are now ready to press play and party!

<hr>

## Acknowledgements

- [David Zukowski](https://zuko.me){{% icon-external %}}: react-redux-starter-kit, which this project began as a fork of (all contributors up until it was detached to its own project are listed on the Contributors page)
Expand Down
2 changes: 1 addition & 1 deletion docs/layouts/partials/sidebar.html
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@ <h1>Karaoke<span class="logo-eternal">Eterna<span class="logo-lastChar">l</span>
<a class="nav-item{{ if eq $lastSeg "faq"}} active{{ end }}" href="{{ .Site.BaseURL }}faq">F.A.Q.</a>
<a class="nav-item{{ if eq $lastSeg "docs"}} active{{ end }}" href="{{ .Site.BaseURL }}docs">Documentation</a>
<ul id="doc-toc">
<li><a href="{{ .Site.BaseURL }}docs/#quick-start">Quick Start</a></li>
<li><a href="{{ .Site.BaseURL }}docs/#karaoke-eternal-the-app">Karaoke Eternal</a> (the app)
<ul>
<li><a href="{{ .Site.BaseURL }}docs/#library">Library</a></li>
Expand All @@ -57,6 +56,7 @@ <h1>Karaoke<span class="logo-eternal">Eterna<span class="logo-lastChar">l</span>
<li><a href="{{ .Site.BaseURL }}docs/#file-locations">File Locations</a></li>
</ul>
</li>
<li><a href="{{ .Site.BaseURL }}docs/#quick-start">Quick Start</a></li>
<li><a href="{{ .Site.BaseURL }}docs/#acknowledgements">Acknowledgements</a></li>
</ul>
</nav>
Expand Down

0 comments on commit 2242320

Please sign in to comment.