Skip to content
haywirephoenix edited this page Oct 26, 2026 · 2 revisions

Floppy for Kodi turns your self-hosted Floppy library into Kodi lists and widgets. It browses shows with Floppy's own watched state, searches through Floppy, and sends your watch history and resume positions straight to Floppy.

New here? Start with Installation, then pick a player in Playback.

Pages

Page What it covers
Installation Installing the add-on and connecting it to Floppy
Browsing The add-on's menus, shows and seasons, the context menu, anime
Widgets Using Floppy lists as skin widgets, with every widget path
Search Search paths for skins
Playback Choosing a player: plugin paths, player files, custom URLs, placeholders
Scrobbling and Resume Sending watch history, saving and resuming positions
Skin Integration ListItem properties and the play hand-off, for skin authors
Troubleshooting Common problems and debug logging

Requirements

  • Kodi 20 (Nexus) or newer.
  • A Floppy instance and its API token.
  • Optional: a TMDb API key, for extra artwork and for collection and people search.
  • Optional: a player add-on to play movies and episodes. Floppy needs no other add-on to browse, track or mark watched.

Clone this wiki locally