Troubleshooting
“Failed to fetch” in the page
Section titled ““Failed to fetch” in the page”The program is not running, or it is on a different port. Start home_screen.exe.
“Cannot bind 127.0.0.1:7878”
Section titled ““Cannot bind 127.0.0.1:7878””Something else is using the port, or a second copy is running. Use --port: see Options.
A new version does not show up
Section titled “A new version does not show up”Hard-refresh with Ctrl+F5. The program also has to be restarted after you replace the file. On Windows you cannot overwrite the exe while it runs: stop it first.
Ctrl+P opens Chrome’s print dialog
Section titled “Ctrl+P opens Chrome’s print dialog”Click into the page first so it has focus. Home Screen overrides the shortcut only while the page is focused.
Icons, favicons or weather are missing
Section titled “Icons, favicons or weather are missing”They need internet access. See Privacy and security for the services involved.
The curl runner says it only works via localhost
Section titled “The curl runner says it only works via localhost”Open the app as http://localhost:7878 or http://127.0.0.1:7878. If you use another name on purpose (a reverse proxy or Docker host), start Home Screen with --allowed-hosts your.name or set HOME_SCREEN_ALLOWED_HOSTS. See Options.
My layout disappeared
Section titled “My layout disappeared”Your data lives in home_screen.db next to the program. Make sure you started the copy that has your database, or pass --db. See Data and backup.
The menu or a dialog looks wrong
Section titled “The menu or a dialog looks wrong”Hard-refresh. If it persists, open an issue (temporary link) with a screenshot and your browser version.
Support the project: Buy Me a Coffee or GitHub Sponsors.