Skip to content

AF-1/jivelite-darkflatskin

Repository files navigation

Dark Flat Skin

piCorePlayer - latest release SB Touch - latest release
SqueezePlay - latest release SB Radio - latest release

A skin for jivelite with a different look, extra information on the Now Playing screen (rating, year, genre, status icons, audio meta data...) and the option to rate a track directly on the Now Playing screen of supported devices.

The skin1 resolution on SqueezePlay or devices running piCorePlayer is 800px x 480px.

Important

Tested with the following (firmware) versions:

  • piCorePlayer: version 10.0.0, ⚠️ only works with the original jivelite, not jivelite-vis
  • SB Touch: firmware version 9.0.1
  • SqueezePlay: app version 9.0.1r1547
  • SB Radio: firmware version 9.0.1r17036

⬅️ Back to the list of all plugins


Features

Please refer to the feature support matrix to find out which features are supported on which devices.

  • display more information on the Now Playing screen(s):

    • rating, year, genre2

    • status icons

      • = is lossless
      • = has lyrics
      • = has a custom start/stop time that the CSST plugin can use
      • = is a remote track (replaced by streaming service icon if track is part of the LMS library)
    • audio meta data (content type, bitrate, sample rate/size, replay gain3)

    • time4, WiFi link quality5

    • NowPlaying screen with lyrics (SqueezePlay and piCorePlayer)

  • rate the current track directly on the Now Playing screen (Ratings Light plugin required)

  • SB Touch:

    • use remote keys to quickly rate tracks (Ratings Light plugin required) (see FAQ)

    • use a remote skin version of DFS called Dark Flat Skin Large (Settings > Screen > Select Skin > Remote Skin).

    • new option to keep the enabled / active DFS skin after a reboot: can be DFS Touch or Remote version. (Settings > Screen > Select Skin)

  • option to replace the Shuffle and Repeat buttons with (half-star) rating buttons

  • option to hide the Shuffle button and / or the Repeat button (will increase width of Play, Fwd and Rew buttons)

  • easy way to install and uninstall the skin using an installer applet

  • display the track title in a different color if the track's comments tag contains a user-specified keyword

  • different look (flat, dark)


Feature Support Matrix

Feature piCorePlayer SqueezePlay SB Touch SB Radio
NP6 screen - display rating
NP screen - display audio metadata
NP screen - display year
NP screen - display replay gain3
NP screen - display lyrics
NP screen - display genre2
NP screen - display time4 ⚪️
NP screen - display WiFi link quality5 ⚪️
NP screen - set rating
UI changes (flat, dark)
incl. fonts to display rating stars in track titles
colored track title triggered by comments tag
incl. a few VU meters
optional (half-star) rating buttons



Tip

If you're already using the Ratings Light plugin, you can display the titles of rated tracks with appended ratings stars - in all menus / lists that use title formats.
Go to the Ratings Light plugin page for screenshots and instructions on how to enable this.


This skin comes with a limited selection of VU meters (some adapted from pCP) and the default spectrum visualizer. If you're more interested in VU meters and spectrum visualizers, try jivelite-vis on piCorePlayer 10+ instead.

The settings are split between Settings > Screen > Now Playing and Settings > Screen > Dark Flat Skin.


Screenshots7





















Grid skin (home menu) - piCorePlayer only




SB Radio








Installation

Tip

To check the currently installed version go to:

  • piCorePlayer, SB Touch, SqueezePlay: Settings > Screen > Dark Flat Skin

  • SB Radio: Settings > Advanced > Uninstall Dark Flat Skin

First you install the skin installer applet which you will then use to install the skin.

#1 - Get the installer

  • Make sure that your LMS and your device have internet access.

  • Go to Settings > Advanced > Applet Installer.

  • Select and install the Dark Flat Skin Installer. Then:

    • piCorePlayer: just restart jivelite using the Quit menu item. Do not reboot piCorePlayer.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.

#2 - Install the skin

  • You should see a new menu item called Dark Flat Skin Installer at the top of the home menu.

  • Follow the menu instructions. To complete the installation:

    • piCorePlayer: jivelite will restart automatically. Does not require a piCorePlayer reboot.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.

#3 - Enable the Dark Flat Skin

  • Go to Settings > Screen > Select skin to enable the Dark Flat Skin.

    • ❗️ SB Touch only:
      • set the Touch Skin  → Dark Flat Skin

      • set the Remote Skin  → Dark Flat Skin Large (Remote Skin)

      • set the Enabled skin after reboot to DFS Touch Skin - or even DFS Remote Skin if you're always using SB Touch from a distance

  • Browse the FAQ article headlines on this page.


Updating to a newer version

#1 - Get the update

  • Go to Settings > Advanced > Applet Installer.

  • Select and update the Dark Flat Skin Installer. Then:

    • piCorePlayer: just restart jivelite using the Quit menu item. Do not reboot piCorePlayer.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.

#2 - Update the skin

  • You should see a new menu item called Dark Flat Skin Updater at the top of the home menu.

  • Follow the menu instructions. To complete the installation:

    • piCorePlayer: jivelite will restart automatically. Does not require a piCorePlayer reboot.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.




Uninstalling the skin

#1 - Remove Dark Flat Skin Installer from the list of installed applets

  • Go to Settings > Advanced > Applet Installer.

  • Select and remove the Dark Flat Skin Installer. Then:

    • piCorePlayer: restart jivelite by using the Quit button.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.

#2 - Remove the skin

  • Enable a different skin.

  • Go to Settings > Advanced > Uninstall Dark Flat Skin and follow the menu instructions.

    • piCorePlayer: jivelite will restart automatically. No reboot necessary.

    • SqueezePlay: quit and restart SqueezePlay manually.

    • SB Touch / SB Radio: your device will reboot automatically.





FAQ

»I've used the Applet Installer to install the Dark Flat Skin Installer/Updater but there's no menu item with this name.«

  • Confirm that your device has (unlimited) access to the internet. The jivelite Applet Installer (Settings > Advanced > Applet Installer) gets the list of available applets from your (local) LMS server. Your device will then (try to) download the applet directly from the source (URL).

  • Doesn't happen very often but still: the server hosting the applet files (http://af1.jerq.org/) could be down. Just try again later.

  • piCorePlayer: If you're running piCorePlayer 10+, go to the Tweaks page (web UI), scroll down to jivelite and make sure that you are using the original jivelite and not jivelite-vis. This applet does not work with jivelite-vis.

  • piCorePlayer: You have downloaded and installed the DFS skin installer applet package. But then instead of using the Quit menu item which only restarts jivelite, you rebooted piCorePlayer (not necessary). If you did so without backing up changes to the SD card, the skin installer applet package did not survive the pCP reboot (because it was not saved).
    In short: Just use the Quit memu item to restart jivelite. Do not reboot pCP at this point.


»The Applet Installer doesn't show me the latest applet version.«

  • Go to Settings -> Advanced -> Applet Installer and confirm that Recommended Applets Only is disabled.

  • Confirm that your server and device both have internet access.

  • If it's a caching problem, try this:

    • reload the LMS Settings -> Manage Plugins page so the server has the latest list of available applets

    • if you enter the Settings -> Advanced -> Applet Installer menu and it doesn't show the latest update, exit the menu and wait a couple of minutes before calling it again.


»I can't open the Screen > NowPlaying > NowPlaying Views menu.«

This is a jivelite quirk that's not tied to any skin in particular. Just enter the NowPlaying screen using the top right note icon. Then go back and try again. That usually solves it. If not, make sure that you have selected a player and that this player is connected.


»How do I switch to next NowPlaying screen from the lyrics NowPlaying screen?«

You need to click/touch the track title in the title bar. The lyrics (text) cannot be used for that because you can scroll up or down in the song lyrics using click-hold/touch-hold.


»I have changed some skin settings. When I go to the Now Playing screen immediately afterwards, the Now Playing screen does not display the changes, the screen layout is wrong or the buttons don't work as they should.«

Sometimes you need to switch to another Now Playing view before the changes take effect.


»Clicking/touching the stars on the NowPlaying screen does not change the rating. Why?«
»How Do I unrate a track on the NowPlaying screen?«
»How do I change the track rating by half a star on the NowPlaying screen?«

To rate a track directly on the Now Playing screen, the track must be part of the LMS library (applies to local and remote/online tracks). And you need the Ratings Light plugin. Make sure the Now Playing screen setting Rate tracks directly on screen is enabled.

To unrate a track click/touch the space to the left or right of the rating stars. Since the space to the left of the rating stars is quite small on Now Playing views with artwork, it's probably better to click/touch the space to the right (about 40px wide).

Alternatively or additionally, you can replace the Shuffle and Repeat buttons on Now Playing views that display track ratings with rating buttons that will increase or decrease the track rating by half a star. This setting is not enabled by default and can be change here: Settings > Screen > Dark Flat Skin.

On SB Touch devices you can use your remote keys to rate tracks (Ratings Light plugin required). The assignment of the SB Touch remote control buttons is explained in a FAQ further below.


»I've selected a different VU meter design but it still displays the old one.«

Please note: on piCorePlayer, the VU meter you select for the Dark Flat Skin is also used by the Dark Flat Grid Skin. You can't set a different VU meter for the Grid skin.

For guaranteed success:

  • SqueezePlay: restart SqueezePlay.
    On Windows (and possibly Linux) selecting a different VU meter requires admin privileges. Please read the corresponding FAQ article below

  • piCorePlayer: use the Quit button to restart jivelite.

  • SB Touch: reboot your device.

Works sometimes:

  • Go to Settings > Screen > NowPlaying > NowPlaying views.

  • Deselect the analog VU meter view.

  • Exit the menu.

  • Then reenter the menu and select the analog VU meter view again.


»SB Touch: Which buttons on the remote control should I use for rating?«

Rate the track currently playing on your SB Touch by holding down a button on the IR remote.

Press and hold the key until you see the new track rating on your display confirming the new track rating.

Key map:
keys 1 to 5 = 1 to 5 stars
0 = unrate
6 = subtract 1 star from current rating
7 = add 1 star to current rating
8 = subtract 0.5 stars from current rating
9 = add 0.5 stars to current rating


»SB Touch: after a reboot the device seems to fall back to the WQVGAsmallSkin skin. Selecting the Dark Flat Skin doesn't stick.«

On your SB Touch device:

  • Go to Settings > Screen > Select Skin

  • set the Touch Skin  → Dark Flat Skin

  • set the Remote Skin  → Dark Flat Skin Large (Remote Skin)

  • set the Enabled skin after reboot  → DFS Touch Skin - or even DFS Remote Skin if you're always using SB Touch from a distance


»piCorePlayer: I've enabled the analog VU meter and spectrum visualizer NowPlaying views but when I toggle through the NowPlaying views, these two are missing.«

The VU meter and spectrum visualizer are only displayed if the device running jivelite is also a local player (e.g. if you have SqueezeLite running on your piCorePlayer device).


»SQUEEZEPLAY on WINDOWS and LINUX«

WINDOWS:
Installing and uninstalling the skin and changing the VU meter design require admin privileges on Windows, i.e. you need to `run SqueezePlay as admin` to install, uninstall or change the VU meter design.

The installer has to rename files in and copy files to the NowPlaying and Clock applet folders in the protected jive applet folder. And on Windows, creating symbolic links (to change the VU meter design) seems to require admin privileges too.

LINUX:
It probably depends on where you've installed SqueezePlay. The installer requires write permissions (755) to rename files in and copy files to the NowPlaying and Clock applet folders in the jive applet folder.
If you install the skin using sudo, it will install the userpath skin files in the root user's home folder. And nobody wants to run SqueezePlay as root all the time.
So either the installer can write to the jive applet folder or you install the applet (files) manually.





Report a new issue

To report a new issue, please file a GitHub issue report.

If you'd like me to make small changes to the skin, please test the new changes on your device/OS first and then create a pull request with the changes here.


⭐ Help others discover this project

If you find this project useful, giving it a star (top right of this page) is a great way to show your support and help others discover it. Thank you.



Footnotes

  1. Based on JogglerSkin (piCorePlayer, SqueezePlay), WQVGAsmallSkin (SB Touch) and QVGAlandscapeSkin (SB Radio).

  2. Genre is only displayed on piCorePayer and SqueezePlay. Not enough screen space on SB Touch or SB Radio. 2

  3. Replay gain is only displayed in NowPlaying views with enough screen space:
      - piCorePlayer and SqueezePlay: (small) Artwork and Text + Text only
      - SB Touch: Text only 2

  4. The small digital clock / time is only displayed in NowPlaying views with enough screen space:
      - piCorePlayer and SqueezePlay: (small and large) Artwork and Text
      - SB Radio: displays time by default in both NowPlaying views 2

  5. The WiFi link quality is only displayed in the NowPlaying view (small) Artwork and Text on piCorePlayer. And only if the active network interface is wireless.
    SB Radio displays an icon for the WiFi connection status / quality by default 2

  6. NP screen = Now Playing screen

  7. The screenshots might not correspond to the current UI in every detail.

About

A skin for jivelite with a different look and extra information on the “Now Playing“ screen (ratings, status icons, audio meta data, lyrics). You can also rate a track directly on the “Now Playing“ screen of supported devices.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages