🎵 PIXOO64 Media Album Art Display

This AppDaemon script for Home Assistant enhances your music experience by displaying relevant information on your DIVOOM PIXOO64 screen. When music plays, the script automatically fetches and displays the album art of the current track. If album art isn't available, it can generate an image using AI, ensuring a visually engaging experience. The script also supports synchronized lyrics, artist and track info, and can even sync an RGB light's color to match the album art.

🎨 Examples

Here’s a summary of the main features:

• Dynamic Album Art: Displays album art on your PIXOO64 when a track starts playing, scaling and preparing the image for the 64x64 pixel display.
• Intelligent Fallback: If album art is unavailable, the script tries to find it online (Spotify, Discogs, Last.fm, MusicBrainz). If all else fails, it generates a unique image using AI.
• Lyrics Sync: Fetches and displays synchronized lyrics for supported media sources, advancing as the song plays. (Note: Not all sources support lyrics.)
• Real-Time Info: Displays the current time, artist's name, and track title on the screen.
• Spotify Album Slide: Shows a slideshow of album covers related to the current track, using the Spotify API.
• Dynamic Lighting: Synchronizes an RGB light's color with the album art's primary color.
• Special Mode: An optional display mode combining album art with a clock, day, and temperature, plus artist/title info.

---

🔧 Prerequisites

Before you begin, make sure you have the following:

1. DIVOOM PIXOO64:
   • Purchase the device from AliExpress.
2. Home Assistant:
   • Ensure you have Home Assistant installed and running with add-on functionality.
3. AppDaemon:
   • Install the AppDaemon add-on in Home Assistant (instructions below).

---

🛠️ Installation

Follow these steps to install and set up the PIXOO64 Media Album Art Display script.

Step 1: Install AppDaemon

Click to expand installation steps

1. Open Home Assistant in your web browser.
2. Navigate to Settings > Add-ons.
3. Click the Add-on Store button (lower right corner).
4. Search for "AppDaemon" and install it.
5. After installation, start the AppDaemon add-on.

Step 2: Install Required Python Packages

Click to expand Python package installation

1. Go to the AppDaemon add-on configuration page (found in the Add-ons page where you started AppDaemon).
2. Locate the Python packages section.
3. Add pillow to the list. This package is required for image processing.
4. Optionally, add python-bidi. This is required to correctly display right-to-left text (e.g., Arabic, Hebrew).
5. Save the changes. This will install the necessary Python libraries.

python_packages:
    - pillow
    - python-bidi  # Optional: Required for RTL text support (e.g., Arabic, Hebrew)

Step 3: Create a Toggle Helper

Click to expand toggle helper creation

1. In Home Assistant, go to Settings > Devices & Services.
2. Click on Helpers.
3. Click the Create Helper button (lower right corner).
4. Select Toggle and give it an appropriate name (e.g., PIXOO64 Album Art).
5. Note the entity_id of this helper (e.g., input_boolean.pixoo64_album_art); you will need it later for configuration.
   • Important: Ensure this new helper entity is toggled ON. If it's off, the script will not run. This toggle allows you to easily disable the script when needed.

Step 4: Download the Script

You can install the script using either HACS (Home Assistant Community Store, recommended) or by manually downloading the Python file.

HACS (Recommended)

• When installing through HACS, you MUST manually move all files from /addon_configs/a0d7b954_appdaemon/apps/ to /homeassistant/appdaemon/apps/.
• HACS places files in the /homeassistant directory (which can also be mapped as /config directory), while AppDaemon expects them in the /addon_configs directory.
• If you're using the SAMBA SHARE add-on, Windows File Explorer will show the directory as /config, meaning that files should be moved to /config/appdaemon/apps/.

1. Open /addon_configs/a0d7b954_appdaemon/appdaemon.yaml and configure it by adding the following line under appdaemon::

   appdaemon:
      app_dir: /homeassistant/appdaemon/apps/ # DO NOT CHANGE THIS LINE, even if the files are located in the /config directory (when using Samba Share addon)
      latitude: 51.507351 # Update value from https://www.latlong.net
      longitude: -0.127758 # Update value from https://www.latlong.net

2. Do not remove any existing lines from the file; just add the new line and update the Latitude and Longitude values from https://www.latlong.net

3. If you don’t have HACS installed, follow the instructions on the HACS GitHub page to install it.

4. After HACS is set up:

   • Go to the HACS page in Home Assistant.
   • If "AppDaemon" repositories are not found, enable AppDaemon apps discovery and tracking in HACS settings:
     • Navigate to Settings > Integrations > HACS > Configure.
     • Enable AppDaemon apps discovery & tracking.
   • Click on Custom Repositories and add https://github.com/idodov/pixoo64-media-album-art as an AppDaemon repository.
   • Search for and download PIXOO64 Media Album Art in HACS.

Manual Download

With this method, you will not receive automatic updates.

• Download the Python script directly from the GitHub repository Download Link
• Place the file into the directory /addon_configs/a0d7b954_appdaemon/apps.

Step 5: Configure AppDaemon

To activate the script, you’ll need to modify the apps.yaml file. This file is typically located in the /appdaemon/apps directory that you added in the previous step.

Basic Configuration

For a minimal setup, add the following to your `/appdaemon/apps/apps.yaml` file. Adjust the `ha_url`, `media_player`, and `url` parameters to match your setup.

pixoo64_media_album_art:
    module: pixoo64_media_album_art
    class: Pixoo64_Media_Album_Art
    home_assistant:
        ha_url: "http://homeassistant.local:8123"   # Your Home Assistant URL.
        media_player: "media_player.living_room"    # The entity ID of your media player.
    pixoo:
        url: "192.168.86.21"                        # The IP address of your Pixoo64 device.

If you have more than one PIXOO64 screen, you can add another configuration block and change the first line's name. For example:

pixoo64_media_album_art_2:
    module: pixoo64_media_album_art
    class: Pixoo64_Media_Album_Art
    home_assistant:
        ha_url: "http://homeassistant.local:8123"   # Your Home Assistant URL.
        media_player: "media_player.tv_room"        # The entity ID of your media player.
    pixoo:
        url: "192.168.86.22"                        # The IP address of your Pixoo64 device.

Full Configuration

For all features, use the following configuration. Adjust the values to match your Home Assistant setup and PIXOO64's IP address.

pixoo64_media_album_art:
    module: pixoo64_media_album_art
    class: Pixoo64_Media_Album_Art
    home_assistant:
        ha_url: "http://homeassistant.local:8123"   # Your Home Assistant URL.
        media_player: "media_player.living_room"    # The entity ID of your media player.
        toggle: "input_boolean.pixoo64_album_art"   # An input boolean to enable or disable the script's execution.
        pixoo_sensor: "sensor.pixoo64_media_data"   # A sensor to store extracted media data.
        temperature_sensor: "sensor.temperature"    # HomeAssistant Temperature sensor name instead of the Divoom weather.
        light: "light.living_room"                  # The entity ID of an RGB light to synchronize with the album art colors.
        ai_fallback: "turbo"                        # The AI model to use for generating alternative album art when needed (supports 'flux' or 'turbo').
        force_ai: False                             # If True, only AI-generated images will be displayed all the time.
        musicbrainz: True                           # If True, attempts to find a fallback image on MusicBrainz if other sources fail.
        spotify_client_id: False                    # Your Spotify API client ID (needed for Spotify features). Obtain from https://developers.spotify.com.
        spotify_client_secret: False                # Your Spotify API client secret (needed for Spotify features).
        tidal_client_id: False                      # Your TIDAL API client ID. Obtain from https://developer.tidal.com/dashboard.
        tidal_client_secret: False                  # Your TIDAL client secret.
        last.fm: False                              # Your Last.fm API key. Obtain from https://www.last.fm/api/account/create.
        discogs: False                              # Your Discogs API key. Obtain from https://www.discogs.com/settings/developers.
    pixoo:
        url: "192.168.86.21"                        # The IP address of your Pixoo64 device.
        full_control: True                          # If True, the script will control the Pixoo64's on/off state in sync with the media player's play/pause.
        contrast: True                              # If True, applies a 50% contrast filter to the images displayed on the Pixoo.
        colors: False                               # If True, enhanced colors.
        kernel: False                               # If True, add emboss/edge effect.
        sharpness: False                            # If True, add sharpness effect.
        special_mode: False                         # Show day, time, and temperature above in the upper bar.
        info: False                                 # Show information while fallback.
        clock: True                                 # If True, a clock is displayed in the top corner of the screen.
        clock_align: "Right"                        # Clock alignment: "Left" or "Right".
        tv_icon: True                               # If True, displays a TV icon when audio is playing from a TV source.
        lyrics: False                               # If True, attempts to display lyrics on the Pixoo64 (show_text and clock will be disabled).
        lyrics_font: 2                              # Recommend values: 2, 4, 32, 52, 58, 62, 48, 80, 158, 186, 190, 590. More values can be found at https://app.divoom-gz.com/Device/GetTimeDialFontList (you need ID value).
        limit_colors: False                         # Reduces the number of colors in the picture from 4 to 256, or set it to False for original colors.
        spotify_slide: False                        # If True, forces an album art slide (requires a Spotify client ID and secret). Note: clock and title will be disabled in this mode.
        images_cache: 25                            # The number of processed images to keep in the memory cache. Use wisely to avoid memory issues (each image is approximately 17KB).
        show_text:
            enabled: False                          # If True, displays the artist and title of the current track.
            clean_title: True                       # If True, removes "Remastered," track numbers, and file extensions from the title.
            text_background: True                   # If True, adjusts the background color behind the text for improved visibility.
            special_mode_spotify_slider: False      # Create animation album art slider.
        crop_borders:
            enabled: True                           # If True, attempts to crop any borders from the album art.
            extra: True                             # If True, applies an enhanced border cropping algorithm.
    wled:
        wled_ip: "192.168.86.55"                    # Your WLED IP Address.
        brightness: 255                             # 0 to 255.
        effect: 38                                  # 0 to 186 (Effect ID - https://kno.wled.ge/features/effects/).
        effect_speed: 50                            # 0 to 255.
        effect_intensity: 128                       # 0 to 255.
        palette: 0                                  # 0 to 70 (Palette ID - https://kno.wled.ge/features/palettes/).
        only_at_night: False                        # Runs only during nighttime hours.

With these steps completed, you have installed and set up the script and can now configure it to fit your needs.

Make sure that input_boolean.pixoo64_album_art is toggled ON. The next time you play a track, the album cover art will be displayed, and all usable picture data will be stored in a new sensor.

🛠️ Configuration Parameters

Below is a detailed breakdown of all the configuration parameters for the PIXOO64 Media Album Art Display script. These parameters allow you to customize the behavior of the script to suit your needs.

Core Parameters

Parameter	Description	Example Values
ha_url	The URL of your Home Assistant instance.	"http://homeassistant.local:8123"
media_player	The entity ID of your media player.	"media_player.living_room"
toggle	Boolean sensor to control script execution (optional).	"input_boolean.pixoo64_album_art"
pixoo_sensor	Sensor to store extracted media data (optional).	"sensor.pixoo64_media_data"
light	RGB light entity ID to sync with album art colors (optional).	False or "light.living_room"
ai_fallback	AI model to generate alternative album art (flux or turbo).	"turbo"
temperature_sensor	Home Assistant temperature sensor to display instead of Divoom weather (optional).	"sensor.temperature"
musicbrainz	Search for album art in MusicBrainz if other sources fail.	True
spotify_client_id	Spotify API client ID (required for Spotify features).	False or "your_spotify_client_id"
spotify_client_secret	Spotify API client secret (required for Spotify features).	False or "your_spotify_client_secret"
tidal_client_id	TIDAL API client ID (optional).	False or "your_tidal_client_id"
tidal_client_secret	TIDAL API client secret (optional).	False or "your_tidal_client_secret"
last.fm	Last.fm API key (optional).	False or "your_lastfm_api_key"
discogs	Discogs personal token (optional).	False or "your_discogs_token"

PIXOO64 Specific Parameters

Parameter	Description	Example Values
url	The IP address of your PIXOO64 device.	"192.168.86.21"
full_control	Control the PIXOO64's on/off state in sync with the media player's play/pause.	True
contrast	Apply a 50% contrast filter to images displayed on the PIXOO64.	True
sharpness	Apply a sharpness filter to images.	True
colors	Enhance colors in the displayed image.	True
special_mode	Show day, time, and temperature in the upper bar.	False
clock	Display a clock in the top corner of the screen.	True
clock_align	Align the clock to the left or right side of the screen.	"Left" or "Right"
tv_icon	Display a TV icon when audio is playing from a TV source.	True
lyrics	Display synchronized lyrics (disables show_text and clock).	True
lyrics_font	Font ID for displaying lyrics. See DIVOOM Fonts.	2, 4, 32, 52, etc.
limit_colors	Reduce the number of colors in the image (4–256) or use original colors (False).	4 to 256 or False
spotify_slide	Enable an album art slideshow using Spotify API (requires API keys).	True
images_cache	Number of processed images to keep in memory cache (each image ≈ 17KB).	1 to 500

Text Display Options

Parameter show_text	Description	Example Values
enabled	Display artist and track title information.	True
clean_title	Remove "Remastered," track numbers, and file extensions from the title.	True
text_background	Adjust the background color behind the text for better visibility.	True
special_mode_spotify_slider	Use Spotify animation when special_mode is enabled and show_text is active.	True

Image Cropping Options

Many album covers come with borders that can distort the display on the PIXOO64's 64x64 pixel screen. The crop_borders feature ensures these borders are removed for a cleaner look.

Parameter crop_borders	Description	Example Values
enabled	Crop borders from album art images.	True
extra	Apply enhanced border cropping for better results.	True

Original	Crop	Extra

pixoo64_media_album_art:
    module: pixoo64_media_album_art
    class: Pixoo64_Media_Album_Art
    pixoo:
        crop_borders:
            enabled: True  # If True, attempts to crop any borders from the album art.
            extra: True    # If True, applies an enhanced border cropping algorithm.

WLED Configuration

Parameter	Description	Example Values
wled_ip	The IP address of your WLED device.	"192.168.86.55"
brightness	Brightness level for WLED lights (0–255).	255
effect	WLED effect ID (see WLED Effects).	0 to 186
effect_speed	Speed of the WLED effect (0–255).	50
effect_intensity	Intensity of the WLED effect (0–255).	128
palette	WLED palette ID (see WLED Palettes).	0 to 70
only_at_night	Run WLED automation only during nighttime hours.	True

Additional Notes

Light Feature

The light parameter allows you to sync RGB lights with the dominant color of the album art. If the image is black, white, or gray, a soft random color will be selected. You can configure multiple lights using the following syntax:

pixoo64_media_album_art:
   module: pixoo64_media_album_art
   class: Pixoo64_Media_Album_Art
   home_assistant:
      light:
        - "light.living_room"
        - "light.bed_room"

WLED Integration

The WLED feature is designed specifically for WLED lights. It sends a "turn on" command with RGB values corresponding to the dominant colors in the album art. You can control brightness, effects, and palettes, and optionally restrict automation to nighttime hours.

pixoo64_media_album_art:
   module: pixoo64_media_album_art
   class: Pixoo64_Media_Album_Art
   wled:
        wled_ip: "192.168.86.55"                    # Your WLED IP Adress
        brightness: 255                             # 0 to 255
        effect: 38                                  # 0 to 186 (Effect ID - https://kno.wled.ge/features/effects/)
        effect_speed: 50                            # 0 to 255
        effect_intensity: 128                       # 0 to 255
        pallete: 0                                  # 0 to 70 (Pallete ID - https://kno.wled.ge/features/palettes/)
        only_at_night: False                        # Runs only at night hours

Display Lyrics

When lyrics are displayed above the image, the image will appear 50% darker if both text_background and lyrics are set to True. Note that this feature is not supported for radio stations. Recommend lyrics_font values: 2, 4, 32, 52, 58, 62, 48, 80, 158, 186, 190, 590. More values can be found at https://app.divoom-gz.com/Device/GetTimeDialFontList (you need ID value)

pixoo64_media_album_art:
   module: pixoo64_media_album_art
   class: Pixoo64_Media_Album_Art
   pixoo:
       lyrics: True
       lyrics_font: 2
       show_text:
           text_background: True

Spotify Slider

The Spotify slider enhances the PIXOO64 by showing related album art for the current track. To enable this mode, add your Spotify API keys (client ID and client secret) to apps.yaml and set spotify_slide to True.

pixoo64_media_album_art:
   module: pixoo64_media_album_art
   class: Pixoo64_Media_Album_Art
   home_assistant:
       spotify_client_id: # Your Spotify API client ID (needed for Spotify features). Obtain from https://developers.spotify.com.
       spotify_client_secret: # Your Spotify API client secret (needed for Spotify features).
   pixoo:
       spotify_slide: True

---

🔄 Fallback Image Handling

When the script cannot directly obtain the album art for the currently playing track, it activates a sophisticated fallback system to ensure your PIXOO64 still displays relevant visual information. Below is a summary of the fallback process:

1. Original Album Art

   • The script first tries to use the album art URL provided by the media player.
   • This is the primary method and works for most local media and some streaming services.

2. API Services (Spotify, Discogs, Last.fm, TIDAL)

   • If the original album art is unavailable, the script queries these services in the following order:
     1. Spotify
     2. Discogs
     3. Last.fm
     4. TIDAL
   • The script uses the first image URL it successfully retrieves.

3. MusicBrainz

   • If API services fail, the script queries the MusicBrainz database, an open-source music encyclopedia.
   • MusicBrainz contains many rare artworks but relies on slower server connections, so retrieval may take time.

4. AI Image Generation

   • If all previous methods fail, the script generates an image using artificial intelligence via pollinations.ai.
   • You can choose between two AI models:
     • turbo: Produces vibrant images.
     • flux: Creates artistic and colorful styles.
   • Note: As this is a free service, it may occasionally be laggy or unavailable.

5. Black Screen with Text

   • As a last resort, the script displays a black screen with the artist and title information of the current track.

This multi-layered approach ensures that your PIXOO64 always displays some form of visual content, prioritizing accurate APIs and databases before resorting to AI or text representation.

🔑 API Keys

To enable advanced features like fetching album art from external services, you’ll need API keys for one or more of the following services. These servers are fast and reliable, making them the most recommended option. Below are step-by-step guides to help you obtain these keys.

• Use Spotify, Discogs, Last.fm, or TIDAL APIs for fast and reliable album art retrieval.
• If API services fail, the script falls back to MusicBrainz or AI-generated images.
• Always store your API keys securely in the apps.yaml file.

Spotify API Keys

Obtain your Spotify Client ID and Client Secret from the Spotify Developer Dashboard.

Steps

1. Log in to Spotify Developer Dashboard:
   Go to the Spotify Developer Dashboard and log in with your Spotify account.

2. Create an App:

   • Click on the "Create an App" button.
   • Provide a name and brief description for your app (these fields are mainly for display purposes).

3. Choose Web API:

   • From the Which API/SDKs are you planning to use section, select Web API and press SAVE.
     

4. Copy Client ID and Client Secret:

   • Once your app is created, navigate to the app overview page.
   • Under the Basic Information section, find your Client ID and Client Secret.
   • Copy these values and store them in the apps.yaml file under spotify_client_id and spotify_client_secret.

Discogs API Keys

Generate a personal API key from the Discogs website.

Steps

1. Log in to Discogs:
   Go to the Discogs website and log in with your account.

2. Create a Personal Key:

   • Navigate to the Discogs API documentation.
   • Follow the instructions to create a new personal key (no application creation required).

3. Store the Key:

   • Copy the generated key and store it in the apps.yaml file under discogs.

Last.FM API Key

Obtain an API key by creating an application on the Last.fm developer site.

Steps

1. Log in to Last.fm:
   Go to the Last.fm website and log in with your account.

2. Create an Application:

   • Navigate to the Last.fm API documentation.
   • Follow the instructions to create a new application.
   • Provide a name and brief description for your application.

3. Obtain API Key:

   • Once your application is created, you’ll receive an API key and secret.
   • Copy the API key and store it in the apps.yaml file under last.fm.

Tidal API Keys

Generate a Client ID and Client Secret from the TIDAL developer dashboard.

Steps

1. Create an Application:
   Go to the TIDAL Dashboard and log in with your TIDAL account.

2. Obtain API Key:

   • Once your application is created, you’ll be provided with a Client ID and Client Secret.
   • Copy these values and store them in the apps.yaml file under tidal_client_id and tidal_client_secret.

---

📊 Sensor Attributes

The sensor sensor.pixoo64_media_data is a virtual entity created in Home Assistant. It stores useful metadata extracted from the album cover art of the currently playing song. This includes details like the artist's name, media title, font color, background color, and more. These attributes enable dynamic visual experiences and automation possibilities based on the music being played.

Below is a detailed breakdown of all the attributes provided by the sensor.pixoo64_media_data sensor:

Attribute	Description	Example Value
artist	The original name of the artist.	"Katy Perry"
media_title	The original title of the media (track or album).	"OK"
font_color	The color of the font displayed on the PIXOO64 screen.	"#7fff00"
background_color_brightness	The brightness level of the background color.	128
background_color	The color of the lower part of the background (hexadecimal format).	"#003cb2"
background_color_rgb	The RGB values of the background color (lower part).	[0, 60, 178]
color_alternative	The most common color in the image (hexadecimal format).	"#4f7cb7"
color_alternative_rgb	The RGB values of the most common color in the image.	[120, 59, 11]
images_in_cache	The current number of images stored in memory cache.	7
image_memory_cache	The total memory used by cached images (in KB or MB).	"114.71 KB"
process_duration	The time it takes to process and send the image to the PIXOO64 screen (in seconds).	2.49 seconds
spotify_frames	The number of frames in the Spotify animation (if applicable).	0
pixoo_channel	The channel number used by the PIXOO64 device.	0
image_source	The source of the image (e.g., "Original," "Spotify," "AI").	"Original"
image_url	The URL of the image used for the album art (if available).	"http://homeassistant.local:8123/api/media_player_proxy/..."

Example Sensor Output

Here’s an example of the sensor attributes in action:

artist: SNIFF'N'THE TEARS
media_title: DRIVER'S SEAT
font_color: "#ff00ff"
background_color_brightness: 64
background_color: "#004f72"
color_alternative_rgb: "#004f72"
background_color_rgb:
  - 0
  - 79
  - 114
color_alternative:
  - 246
  - 167
  - 134
images_in_cache: 15
image_memory_cache: 248.23 KB
process_duration: 3.49 seconds
spotify_frames: 0
pixoo_channel: 0
image_source: Last.FM
image_url: >-
  https://lastfm.freetls.fastly.net/i/u/300x300/1903a3660115ea8295053103419e573c.png

---

🛠️ Troubleshooting

If you encounter any issues while setting up or using the PIXOO64 Media Album Art Display script, refer to the troubleshooting guide below. These are some of the most common problems and their solutions:

• Always double-check your configuration (apps.yaml) for typos or missing parameters.
• Ensure proper power supply (3A charger) and Wi-Fi performance for optimal functionality.
• Use appdaemon logging to diagnose issues with the script or integrations.

The PIXOO64 Screen is Blank or Not Updating

Possible Causes:

• The input_boolean.pixoo64_album_art toggle is turned off.
• The media player entity ID in the configuration is incorrect.
• The PIXOO64 device is not connected to the same Wi-Fi network as Home Assistant.
• The script is not running

Solutions:

1. Check the Toggle Helper:

   • Ensure that the input_boolean.pixoo64_album_art toggle is turned ON. You can check this in Home Assistant under Developer Tools.

2. Verify Media Player Entity ID:

   • Double-check the media_player entity ID in your apps.yaml file. It should match the entity ID of your media player in Home Assistant.

3. Check Network Connectivity:

   • Ensure the PIXOO64 device is connected to the same Wi-Fi network as your Home Assistant instance.

4. Check Appdaemon Logs

   • The log can contains reason why the script is fail.

5. Restart AppDaemon:

   • Restart the AppDaemon add-on in Home Assistant to ensure the script is running correctly.

Album Art is Not Displaying

Possible Causes:

• The media player does not provide album art metadata.
• The media player does not provide artist / track metadata.
• API keys for services like Spotify, Discogs, or Last.fm are missing or incorrect.
• The fallback system (MusicBrainz, AI) is not configured properly.

Solutions:

1. Check Metadata Support:

   • Verify that your media player provides album art metadata. Some players (e.g., radio streams) may not include album art.

2. Verify API Keys:

   • Ensure that all required API keys from the servies you choose (Spotify, Discogs, Last.fm, TIDAL) are correctly entered in the apps.yaml file. Refer to the API Keys section for instructions on obtaining these keys.

3. Enable Fallback Options:

   • If album art is unavailable, ensure that fallback options like MusicBrainz or AI image generation are enabled in the configuration:

     musicbrainz: True
     ai_fallback: "turbo"

4. Test with Different Tracks:

   • Try playing tracks from different sources (e.g., Spotify, local files, Radio statations) to see if the issue persists.

AI-Generated Images Are Not Appearing

Possible Causes:

• The AI service (pollinations.ai) is unavailable or laggy.
• The ai_fallback parameter is not set correctly.

Solutions:

1. Check AI Service Status:

   • Visit pollinations.ai to verify that the service is operational. Note that this is a free service and may occasionally be slow or unavailable.

2. Verify Configuration:

   • Ensure that the ai_fallback parameter is set to either "flux" or "turbo" in your apps.yaml file:

     ai_fallback: "turbo"

3. Enable Force AI (Optional):

   • If you want to test AI-generated images exclusively, set force_ai to True:

     force_ai: True

RGB Light Sync Is Not Working

Possible Causes:

• The RGB light entity ID in the configuration is incorrect.

Solutions:

1. Verify Light Entity ID:

   • Double-check the light parameter in your apps.yaml file. It should match the entity ID of your RGB light in Home Assistant:

     light: "light.living_room"

2. Test with Different Images:

   • Play tracks with colorful album art to ensure the RGB light sync works as expected.

Script Performance Issues

Possible Causes:

• Insufficient memory due to a large number of cached images.
• Slow Wi-Fi network or power supply issues.

Solutions:

1. Reduce Image Cache Size:

   • Lower the images_cache value in your apps.yaml file to reduce memory usage:

     images_cache: 10

2. Optimize Power Supply:

   • Use a USB charger with an output of 3A for optimal performance. Limit screen brightness to no more than 90% if using a lower-voltage charger.

3. Reboot Wi-Fi Router:

   • If the PIXOO64 responds slowly, reboot your Wi-Fi router to improve network performance.

Sensor Data is Missing or Incorrect

Possible Causes:

• The sensor.pixoo64_media_data sensor is not updating correctly.
• There is an issue with the media player or AppDaemon script.

Solutions:

1. Check Sensor State:

   • Verify that the sensor.pixoo64_media_data sensor exists and is updating in Home Assistant. You can view its attributes in the Developer Tools.

2. Restart AppDaemon:

   • Restart the AppDaemon add-on to refresh the script and sensor data.

Lyrics Are Not Displaying

Note: Radio stations does not support lyrics.

Possible Causes:

• The track does not have synchronized lyrics that can be found on database.
• Media Player not support needed metadata.
• The lyrics parameter is not enabled in the configuration

Solutions:

1. Verify Media Player Support:

   • Ensure that your media player supports synchronized lyrics (media player contains the attribues: media_duration, media_atrist and media_title).

2. Enable Lyrics in Configuration:

   • Set the lyrics parameter to True in your apps.yaml file:

     lyrics: True

3. Check Font Settings:

   • Ensure that the lyrics_font parameter is set to a valid font ID.

---

⚠️ Disclaimer

This software is not an official product from Divoom. As a result, Divoom bears no responsibility for any damages or issues arising from the use of this script. Additionally, Divoom does not offer end-user support for this script. Please utilize it at your own risk.