Skip to content

Latest commit

 

History

History
214 lines (151 loc) · 7.19 KB

USAGE.md

File metadata and controls

214 lines (151 loc) · 7.19 KB

Tempus Usage Guide

<- back home

Table of Contents

Prerequisites

Important Notice: This app is a Subsonic-compatible client and does not provide any music content itself. To use this application, you must have:

  • An active Subsonic API server (or compatible service) already set up
  • Valid login credentials for your Subsonic server
  • Music content uploaded and organized on your server

Verified backends

This app works with any service that implements the Subsonic API, including:

Getting Started

Installation

  1. Download the APK from the Releases section
  2. Enable "Install from unknown sources" in your Android settings
  3. Install the application

First Launch

  1. Open the application
  2. You will be prompted to configure your server connection
  3. Grant necessary permissions for media playback and background operation

Server Configuration

Initial Setup

IN PROGRESS

  1. Enter your server URL (e.g., https://your-subsonic-server.com)
  2. Provide your username and password
  3. Test the connection to ensure proper configuration

Advanced Settings

TODO

Main Features

Library View

Multi-library

Tempus handles multi-library setups gracefully. They are displayed as Library folders.

However, if you want to limit or change libraries you could use a workaround, if your server supports it.

You can create multiple users , one for each library, and save each of them in Tempus app.

Folder or index playback

If your Subsonic-compatible server exposes the folder tree or provides an artist index (for example Gonic, Navidrome, or any backend with folder browsing enabled), Tempus lets you play an entire folder from anywhere in the library hierarchy:

  • The Library ▸ Music folders screen shows each top-level folder with a play icon only after you drill into it. The root entry remains a simple navigator.
  • When viewing inner folders or artist index entries, tap the new play button to immediately enqueue every audio track inside that folder/index and all nested subfolders.
  • Video files are excluded automatically, so only playable audio ends up in the queue.

No extra config is needed—Tempus adjusts based on the connected backend.

Now Playing Screen

On the main player control screen, tapping on the artwork will reveal a small collection of 4 buttons/icons.

marked the icons with numbers for clarity

  1. Downloads the track (there is a notification if the android screen but not a pop toast currently )
  2. Adds track to playlist - pops up playlist dialog.
  3. Adds tracks to the queue via instant mix function
    • TBD: what is the instant mix function?
    • Uses getSimilarSongs of OpenSubsonic API. Which tracks to be mixed depends on the server implementation. For example, Navidrome gets 15 similar artists from LastFM, then 20 top songs from each.
  4. Saves play queue (if the feature is enabled in the settings)
    • if the setting is not enabled, it toggles a view of the lyrics if available (slides to the right)

Podcasts

If your server supports it - add a podcast rss feed

Radio Stations

If your server supports it - add a internet radio station feed

Navigation

Bottom Navigation Bar

IN PROGRESS

  • Home: Recently played and server recommendations
  • Library: Your server's complete music collection
  • Download: Locally downloaded files from server

Playback Controls

Streaming Controls

TODO

Advanced Controls

TODO

Favorites

Favorites (aka heart aka star) to albums and artists

  • Long pressing on an album gives you access to heart/unheart an album

  • Long pressing on an artist cover gets you the same access to to heart/unheart an album

Playlist Management

Server Playlists

TODO

Creating Playlists

TODO

Settings

Android Auto

Enabling on your head unit

To allow the Tempus app on your car's head unit, "Unknown sources" needs to be enabled in the Android Auto "Developer settings". This is because Tempus isn't installed through Play Store. Note that the Android Auto developer settings are different from the global Android "Developer options".

  1. Switch to developer mode in the Android Auto settings by tapping ten times on the "Version" item at the bottom, followed by giving your permission.

1a 1b 1c

  1. Go to the "Developer settings" by the menu at the top right.

2

  1. Scroll down to the bottom and check "Unknown sources".

3

Server Settings

IN PROGRESS

  • Manage multiple server connections
  • Configure sync intervals
  • Set data usage limits for streaming

Audio Settings

IN PROGRESS

  • Streaming quality settings
  • Offline caching preferences

Appearance

TODO

Troubleshooting

Connection Issues

TODO

Common Issues

TODO

Support

For additional help:

  • Question? Start a Discussion
  • Open an issue if you don't find a discussion solving your issue.
  • Consult your Subsonic server's documentation

Note: This app requires a pre-existing Subsonic-compatible server with music content.