Seanime Logo

UI Customization

Learn how to customize the UI

Library

Color scheme

Seanime allows you to customize the color scheme of the UI by setting custom colors.

  • Go to the UI settings page and Enable color settings
  • Set the background and accent colors to your liking. Be mindful that the background color should be a dark color for better readability.

You can also choose between the predefined color swatches.

Background and Banner

Seanime allows you to customize the UI by setting custom background images and banners.

The images you want to use as banners or backgrounds should be placed in a directory which is configurable in your config.toml file. The default path of the asset directory is $SEANIME_DATA_DIR/assets.

  • Create a directory named assets in your Seanime config directory
  • Place your images in the assets directory
  • In the UI settings, set the image paths to the relative path of the image in the assets directory.

Example

📁 path/to/seanime/data/dir
    ├── config.toml
    ├── seanime.db
    └── 📁 assets               <- New
        ├── 🖼️ banner.jpg
        ├── 🖼️ background.gif
        └── 🖼️ banner-2.gif

Then, set Background image path to background.gif in the UI settings.

How to change the asset directory

  • Change the web.assetdir setting in your config.toml file to whatever you want, the path should be absolute or $SEANIME_DATA_DIR/assets.

Sidebar

  • Expand sidebar on hover: When enabled, the sidebar will expand when you hover over it.
  • Disable transparency: When enabled, the sidebar will have a solid background color.

Navbar

  • Hide top navbar: When enabled, the top navbar will be hidden.

Media Cards

  • Glassy background: When enabled, the media cards will have a glassy gradient background.

Carousel

  • Disable auto-scroll: When enabled, the carousels will not automatically scroll.
  • Smaller episode cards: When enabled, the episode cards in the carousel will be smaller.

Library screens

  • Banner type

    • Dynamic banner: The banner will alternate between different media images.
    • Custom banner: The banner will be the banner image you set in the UI settings.
    • None: The banner will be hidden.

  • Legacy episode cards: When enabled, the episode cards will be displayed in the old style.

  • Blurred gradient on media pages: When enabled, the background of the media pages will have a blurred gradient on scroll.

  • No genre selector: When enabled, the genre filter will be hidden on the library screens.