Skip to content

Customize home page#803

Merged
damontecres merged 64 commits intomainfrom
develop/customize-home
Feb 13, 2026
Merged

Customize home page#803
damontecres merged 64 commits intomainfrom
develop/customize-home

Conversation

@damontecres
Copy link
Copy Markdown
Owner

@damontecres damontecres commented Jan 30, 2026

Description

This PR adds the ability to customize the home page in-app

Features

  • Add, remove, & reorder rows
  • Persist the configuration locally
  • Save the configuration to the server, allowing to pull down on other devices
  • Adjust view options for rows such as card height, image type, preferring series images, or aspect ratio (similar to libraries)
  • Pull down the web client's home rows (no plugins are supported yet!)
  • Preview of the home page which is usable & updated as changes are made

Row options

These are row types that can be added in-app via the UI:

  • Continue watching
  • Next up
  • Combined continue waiting & next up
  • Recently added in a library
  • Recently released in a library
  • Genres in a library
  • Suggestions for a library (movie & TV show libraries only)
  • Favorite movies, tv shows, episodes, etc

Additionally, there are more row types that don't have a UI to add them (yet):

  • Simple query to get items from a parent ID such as a collection or playlist
  • Complex query to get arbitrary items via the /Items API endpoint

Dev notes

Settings are loaded in order:

  1. Locally saved
  2. Remote saved
  3. Fallback to default similar to Wholphin's original home rows

The remote saved settings are stored via the display preferences API.

I know some server admins would prefer to push a default setup to their clients. This PR does not have that ability, but it does define a straightforward API for defining the settings. Something like the potential server plugin work started in #625 could be slimmed down to expose a URL to be added in the load order.

I'm also investigating integration with popular home page plugins to allow for further customization, but will take more time.

TODO

  • How to handle the combined continue waiting & next up settings versus with the rows
  • Better error handling
  • Handling image types for episodes vs movies in continue watching
  • Discover rows

Related issues

Closes #399
Closes #361
Closes #282
Related to #340

Try it out

You can try this out by following the instructions here. There are no database changes, so you can switch back to the regular develop build anytime.

Screenshots

Click to see screenshots

Overview

customize_home_01 Large

Add a new row

customize_home_02 Large

Adjust individual row view options

customize_home_03 Large

Adjust global view options & save/load

customize_home_04 Large

@damontecres damontecres marked this pull request as ready for review February 10, 2026 21:57
@damontecres damontecres merged commit fcba1c7 into main Feb 13, 2026
3 checks passed
@damontecres damontecres deleted the develop/customize-home branch February 13, 2026 00:54
damontecres added a commit that referenced this pull request Feb 13, 2026
## Description
Allows for reordering the items in the navigation drawer

This does not change the home page row order since #803 decouples the
nav drawer and home page rows.

The initial order will be the "Library Order" settings on the web under
Profile->Home. Making any changes locally in Wholphin will set the
order. If any new libraries are added or if Seerr integration is
enabled, these will added to the end of the "pinned" list.

### Related issues
Closes #822
Related to #399 & #803

### Testing
Tested on emulator
- Re-ordering
- Granting/Revoking user permission to a new library

## Screenshots
N/A, nav drawer is the same, just sorted differently

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 13, 2026
## Description
Customizing the home page (#803) and nav drawer (#886) were developed
independently, so this PR just cleans up somethings so that those two
changes work together.

This PR restores the default home page when there is no customization to
be the same as before: continue watching/next up row(s) followed by the
order of the nav drawer libraries' recently added rows.

Finally gets rid of `NavDrawerIteRepository` and related functions which
all had weird, hard to follow code.

### Related issues
Related to #803 & #886

### Testing
Emulator testing

## Screenshots
N/A

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 13, 2026
## Description
Improves home page customization for Live TV & Recordings
- Add row for live tv channels
- Add row for "on now" programs
- Clicking on a TV channel or TV program starts playback
- Better name for "Recently recorded" instead of "Recently added in
Recordings"

Also fixes a back stack issue after adding rows

### Related issues
Follow up from #803 

### Testing
Emulator

## Screenshots
<img width="663" height="190" alt="image"
src="https://github.com/user-attachments/assets/49d41953-42ab-4621-92f1-b7936aab7e97"
/>

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 13, 2026
## Description
- Update header when editing a row
- Exclude non-empty rows to prevent scroll lock
- Only save settings locally if they are different from the source

### Related issues
Related to #803 

### Testing
Emulator, tested remote & local settings changes

## Screenshots
N/A

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 18, 2026
## Description
Fixes several issues with home page customization such as
- Displaying wrong episode-specific display options
- Smaller text on cards without images
- Prefer fill scaling for posters, like the old home page

### Related issues
Related to #803 

### Testing
Emulator

## Screenshots
N/A

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 20, 2026
## Description
Adds a basic way to add a collection or playlist as a row on the home
page.

There's a simple search dialog to find the collection or playlist.

### Related issues
Related to #399 & #803 

### Testing
Emulator testing

## Screenshots
N/A

## AI or LLM usage
None
damontecres added a commit that referenced this pull request Feb 20, 2026
## Description
Hopefully this is the last round of bug fixes for customizing the home
page!

Fixes a possible crash when scrolling after adding a row after resetting
to default or loading remote settings that have more rows than the
original settings

Fixes some incorrect titles

### Related issues
Related to #399 & #803

### Testing
Emulator & nvidia shield

## Screenshots
N/A

## AI or LLM usage
None
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

user interface Related to the user interface

Projects

None yet

2 participants