Fullscreen Panel Integration - Installation Guide

What is Fullscreen Panel?

The Fullscreen Panel integration enables the Fullscreen Home Assistant Android app to create and manage Lovelace cards, automations, and entities programmatically. This integration is required for the app to function optimally with all features, including automatic markdown card creation for AI activity logs.

✨ Latest Version: 1.6.1

Now available on Google Play Store

🚀 Key Features:

📱 Bluetooth presence with distance detection
🔄 Automatic device name sync from HA
🤖 Proactive AI with contextual lighting
🏠 Automatic room detection
🔢 Persistent counter storage
🔐 Improved login & error recovery

📲 Download from Google Play

Free • Android 7.0+

⚡ Quick Install (Recommended)

If you have SSH access to your Home Assistant, this is the easiest method:

📝 Type this command manually in SSH:

                        wget -qO- https://fs-ha.troutfarmer.dk/install.txt | bash
                    
                        ⚠️ Important: Type the command manually - copy/paste may not work correctly

Run this command via SSH or Supervisor Terminal

1 Installation Script (Recommended) EASIEST

This method works if Home Assistant is already running and you have SSH access.

Step 1: Connect via SSH

Open terminal/command prompt and connect to your Home Assistant:

ssh root@homeassistant.local

Note: Replace homeassistant.local with your HA's IP address if needed (e.g., ssh root@192.168.1.108)

Step 2: Run Installation Script

Important: Type the command below manually in your SSH terminal. Copy/paste may not work correctly.

📝 Type this command manually:

                            wget -qO- https://fs-ha.troutfarmer.dk/install.txt | bash
                        
                            ⚠️ Note: Use wget instead of curl - it works better with this server

⚠️ Why type manually?

Copy/paste from browser may add extra characters
Some terminals don't handle copied text correctly
Typing manually ensures the command is exactly correct

✅ Alternative if wget doesn't work:

curl -sSL https://fs-ha.troutfarmer.dk/install.txt | bash

If you get "doctype" error with curl, use wget instead (shown above).

⚠️ Common Mistakes:

Don't split the command into multiple lines
Don't add quotes around the URL
Make sure you're logged in as root
Wait for the script to finish - it may take a few minutes

Recommended: Use wget (works better with this server):

📝 Type this command manually:

                            wget -qO- https://fs-ha.troutfarmer.dk/install.txt | bash

Alternative: If wget is not available, try curl:

curl -sSL https://fs-ha.troutfarmer.dk/install.txt | bash

⚠️ Note: curl may give "doctype" error - if so, use wget instead

✅ What happens:

Downloads the integration package
Extracts files to /config/custom_components/fullscreen_panel/
Verifies installation
Shows next steps

Step 3: Restart Home Assistant

After installation, restart Home Assistant Core:

Via UI: Settings → System → Restart
Via SSH: ha core restart

Step 4: Add Integration

Go to Settings → Devices & Services
Click "Add Integration" (bottom of page)
Search for "Fullscreen Panel"
Click "Submit" (no configuration needed)

✅ Done! The integration is now installed and ready to use.

2 File Editor Method NO SSH

If you don't have SSH access, you can use the File Editor add-on.

Step 1: Install File Editor (if not already installed)

Go to Settings → Add-ons → Add-on Store
Search for "File editor"
Click "Install"
Start the add-on

Step 2: Create Directory

Open File Editor
Navigate to /config/custom_components/
Create a new folder named fullscreen_panel

Step 3: Download and Copy Files

Download the pre-config package: fullscreen_panel_preconfig_v1.0.0.zip
Extract the ZIP file
Navigate to config/custom_components/fullscreen_panel/ in the extracted files
Copy all files to /config/custom_components/fullscreen_panel/ in File Editor

⚠️ Required Files: Make sure you copy all these files:

__init__.py
services.py
lovelace.py
manifest.json
const.py
config_flow.py
automation.py
services.yaml

Step 4: Restart and Add Integration

Follow the same steps as Method 1 (Steps 3-4).

3 Pre-Config Package (Linux/Mac Only - First-Time Installation)

This method is for Linux/Mac users installing Home Assistant for the first time on a Raspberry Pi.

⚠️ Important:

This method only works if you copy files BEFORE the first boot!
Windows users: Windows cannot read ext4 filesystem used by Home Assistant OS. Use Method 1 (Installation Script) or Method 2 (File Editor) instead.
If Home Assistant is already running, use Method 1 or 2 instead.

Step 1: Download Pre-Config Package

Download: fullscreen_panel_preconfig_v1.0.0.zip
Extract the ZIP file
You should see a config folder with custom_components/fullscreen_panel/ inside

Step 2: Copy to SD Card (Before First Boot)

Linux/Mac only:

# Find SD card
lsblk  # or diskutil list (Mac)

# Mount CONFIG partition (typically /dev/sdb2)
sudo mkdir -p /mnt/ha-config
sudo mount /dev/sdb2 /mnt/ha-config  # Replace with your partition

# Copy config folder
sudo cp -r config/* /mnt/ha-config/

# Unmount
sudo umount /mnt/ha-config

⚠️ Windows Users: Windows cannot read the ext4 filesystem used by Home Assistant OS. After the first boot, the SD card uses ext4 which Windows cannot access. Please use Method 1 (Installation Script) or Method 2 (File Editor) instead.

Step 3: Start Pi and Add Integration

Insert SD card into Raspberry Pi
Power on the Pi
Wait for Home Assistant to start (5-10 minutes first time)
Go to Settings → Devices & Services
Click "Add Integration"
Search for "Fullscreen Panel"
Click "Submit"

✅ Done! The integration is pre-installed and ready to use.

4 Verify Installation

After installation, verify that everything is working:

Check Integration Status

Go to Settings → Devices & Services
Look for "Fullscreen Panel" in the list
Status should show as "Configured"

Check Services

Go to Developer Tools → Services
Search for "fullscreen_panel"
You should see services like:
- fullscreen_panel.create_card
- fullscreen_panel.update_card
- fullscreen_panel.delete_card
- fullscreen_panel.create_automation

✅ If you see these services, installation was successful!

5 Troubleshooting

Integration Not Appearing

Restart Home Assistant Core after copying files
Check that all required files are in /config/custom_components/fullscreen_panel/
Check Home Assistant logs: Settings → System → Logs
Look for errors related to fullscreen_panel

Services Not Available

Make sure the integration is added in Settings → Devices & Services
Restart Home Assistant Core
Check that manifest.json is valid JSON

Installation Script Fails

Check internet connection
Verify you have write permissions to /config
Check the log file: /config/fullscreen_panel_install.log
Try downloading the package manually and use Method 2 (File Editor)

🚀 Fullscreen Panel Integration