Floppy

Floppy is one diary for everything you watch, read, play and listen to. Movies, TV down to the episode, anime, manga, books, comics, games, board games, music albums and podcasts each get their own pages, progress and ratings, and it all adds up to a history feed, statistics and a yearly recap of where your time went.

Your history can fill itself in. Plays from Jellyfin, Plex, Emby and Kodi, listens from Pocket Casts, Last.fm and Navidrome, and audiobook progress from Audiobookshelf all land in Floppy without you lifting a finger. A calendar shows the next episode or release for everything you follow, lists can be hand-picked or smart (they fill themselves from rules), and the collection side tracks what you own, down to the format. Floppy started life as a fork of Yamtrack, and it reads Yamtrack's CSV exports.

When does hosted Floppy make sense?

Your tracking is spread across Trakt, Letterboxd and Goodreads. Floppy imports from Trakt, TV Time, Simkl, IMDb, MyAnimeList, AniList, Kitsu, Goodreads, StoryGraph, Hardcover, Steam, PlayStation, Xbox and more, so you start with your history rather than an empty page.
Your media server already knows what you watched. Jellyfin, Plex and Emby tell Floppy what you finished, and episodes tick themselves off.
The whole household wants a diary. You create an account for each person, and they sign in to Floppy with that. No ElfHosted login needed on their side.
You don't want to babysit it. Title lookups for films and TV are set up for you, with no TMDB key to fetch. We keep Floppy updated and back it up daily, with restores you can run yourself from ElfBot.

Get a 7-day trial of ElfHosted Floppy!

How do I access Floppy?

Floppy is available:

From your dashboard: https://your-username.elfhosted.com
Directly: https://your-username-floppy.elfhosted.com

Signed-in users see their own URLs

The addresses above show the general pattern. Sign in and these become your personal, clickable links.

How do I use it?

Create your account first

Floppy has its own logins, separate from your ElfHosted one. Make yours as soon as the instance is ready, because the first account created on your instance becomes its admin.

Open Floppy and follow the sign up link on the sign-in page.
If you aren't already signed in to ElfHosted in that browser, Floppy asks for your ElfHosted login here. Creating accounts is the one part of Floppy that sits behind it.
Pick a username and password. That's your Floppy login from now on.

The first boot takes a minute or so while the database gets ready, and Floppy then walks you through a short guided setup. If the page doesn't load straight away, give it a moment.

Add the family

Only you can create accounts, because the sign-up page needs your ElfHosted login. To add someone, sign out of Floppy (or open a private browser window), go to the sign-up page again, and create an account for them. Then hand them the username and password. They open your Floppy address and sign in with that, and never see an ElfHosted login.

Each person gets their own library, history, stats and settings.

Set up password recovery now

Floppy can't send password reset emails. Instead, each person should add an authenticator app or save their recovery codes under Settings → Account. If someone forgets their password, the forgot password page (also behind your ElfHosted login) takes their username plus an authenticator code or a recovery code and sets a new password. Without one of those there is no way back into the account, so set them up the day each account is created.

Import your history

Open Settings → Import and pick your source. Public Trakt and AniList profiles import by username, Simkl and Plex ask you to sign in, and Goodreads, StoryGraph, IMDb and similar sites take an export file. Imports run in the background, and a large history can take a while because every item is matched against the metadata providers. Carry on using Floppy while it works.

Coming from Yamtrack? Export a CSV from Yamtrack's settings, then import it into Floppy under Settings → Import. The two can run side by side while you try Floppy out.

Log plays from your media server

Floppy's Settings → Integrations page has step-by-step instructions and your personal webhook address for each media server.

Jellyfin: install the Webhook plugin, add a generic destination, and paste in the template and URL Floppy shows you. Jellyfin needs TMDB and TVDB enabled as metadata providers so Floppy can match what you played. Floppy can also pull your existing Jellyfin history in.
Plex: enter your Plex username in Floppy's Plex section, then add the webhook URL under Settings → Webhooks in Plex. Plex only sends webhooks with Plex Pass.
Emby: add the webhook URL under Settings → Notifications.
Kodi: install the HTTP Scrobbler add-on and give it the webhook URL.

If that media server is also on your ElfHosted account, it can reach Floppy directly on the internal address instead of going out and back in:

http://floppy:8000/webhook/jellyfin/<your token>

Swap jellyfin for plex or emby as needed. Media servers hosted elsewhere use the full https://<your username>-floppy.<domain>/webhook/... address (replace <domain> with the domain in your dashboard's address, for example elfhosted.com).

Music and podcasts connect on the same page: Pocket Casts and Last.fm by account, Navidrome through its ListenBrainz scrobbler setting, and Audiobookshelf with its server address and an API token.

The calendar has an iCal feed you can add to Google Calendar, Apple Calendar or anything else that subscribes to a URL. Copy the link from the calendar page.

Treat webhook and calendar links like passwords

Webhook and calendar addresses work without signing in, because a media server or calendar app can't type a password. The token in each address is what protects them, and it's the same token that unlocks your account through Floppy's API. If one ends up somewhere it shouldn't, regenerate the token under Settings → Integrations, then paste the new addresses into your media server and calendar app.

Use the API

Floppy has a REST API at /api/v1, and a signed-in browser can read the API index at /api/docs/. For apps and scripts, create an app token under Settings → Integrations rather than using your main token: app tokens can be limited and revoked one at a time.

More integrations

The step-by-step setup is available to logged-in customers. Sign in to continue →

Floppy also works with

How do I get support for Floppy?

For general use of Floppy, refer to the official site or to one of the links in the resources section below.
For specific support re your ElfHosted configuration / account, see the ElfHosted support options!

You can contribute directly to the development of Floppy using the following:

GitHub Sponsors

Floppy resources

What users say..

We're rocking some excellent TrustPilot Reviews, and here's what some of our ~~users~~friends say..

I am new here, but today I learned realized that Elfhosted is one of the best free and open source software communities I've seen, and FOSS communities have been at the center of my life since the 90s (Perl, PHP, Symfony, Drupal, Ethereum, etc.). Great open software built by great people who care = great community, and that is something special.

You've done an amazing job @Funky Penguelf with the platform you provide and this place has an awesome mix of active community caretakers and software creators that I've seen here so far like BSM, Spoked, LayeZee and other elf vengers. Keep up the energy, productivity and community and take time to enjoy it and appreciate each other!

@skwah (Discord)

As a happy Elfhosted customer—who also self hosts MANY things across about 10 severs (dedicated, VPSes, and VMs running on Synology), I wouldn’t switch to self hosting the services I get from Elfhosted. They just work with very little effort configuring things, and the support the owner and his team provides is second to none. Plus I love being part of a fledgling—but quickly growing—enterprise.

/u/jatguy. (Reddit)

I’ve been using this service for a while now, and honestly, it’s a game-changer compared to anything else I’ve tried for managing my media library. The support is fantastic—super quick, and if the staff aren’t around (which rarely happens), the community steps up right away. I can’t imagine going back to any other platform.

Before this, I had my own setup with a NUC, NAS, and tools like Sonarr and Radarr. It worked pretty well for a while, and my internet speed was high enough to stream without any buffering. But in the end, it wasn’t worth the time or headache of managing all the storage and keeping everything running smoothly.

Now, with this service, everything runs smoothly in 1080p+ with no buffering issues. The interface is really easy to use, which makes managing everything a breeze. Plus, having a whole community of smart people available for guidance is a huge bonus.

I was sold from the start, which is why I quickly upgraded from a 1-month to a 3-month subscription, and I’m planning to switch to a 1-year plan soon. This service totally pays for itself, and I’m sure you won’t be disappointed. It’s been really impressive.

@seapound (Discord)

Best possible options for anyone looking for the do-it-all option along with the best customer service ive experienced in this space so far. Id rate it a 6 if I could but its limited to 5/5...

@hashmelters (Discord)

(responding to a discussion re the cost of ElfHosted vs mainstream streaming / self-hosting):

I didn't know that the goal of this project was to compete with large companies running/renting entire DCs. I was under the impression that the goal of this project was to manage the updating of almost selfhosted applications on a shared platform with other users. Basically, be my sysadmin for me.

That being said, paying for services is the 'easy button'. There is a real world cost incurred for the time saved. Time is money. Time is the most valuable currency that exists. Once time is spent, it's forever lost, one cannot retrieve it again (yet). In my mind, there are 3 options for use of time with respect to: mainstream, selfhosting, elfhosted.

mainstream - my time is valuable and I don't want curated content and I don't care what content that I have the ability to consume. I only like what's popular.

elfhosted - my time is valuable, I want my own curated content without being forced to browse past the same damn entry 500 times just to find out that I can't watch the movie I want because it's not available in my current location or was removed last week from mainstream providers.

selfhost - I care about costs and I have nothing but time to waste or I want to learn about the backend of the systems involved. I'll pay for my own VPS/homelab, electricity, manage the OS, manage app updates, figure out how to make the apps talk nice to each other, create my own beautiful frontend.

I know how much my time is worth, does that reddit poster know how much their time is worth? Without knowing what you are worth, you can't make effective capital expenditures with respect to the time it will take to recoup the capital.

I know I don't need elfhosted at all for my use case. I choose to stay with elfhosted because it's my 'easy button'. It's an efficient capital expense for the amount of time it saves me managing my own hardware, apps and saves me electricity costs. I'm also in a situation where I don't have upload bandwidth from my home to serve HD content to myself remotely. If I lived back in a city, I would still be here. My time is worth $$/hr.

@cobra2 (Discord)

"Just wanted to check in here and let @Darth-Penguini and anyone/everyone else know...WOW. I have been struggling with storage for years, maintenance of Docker containers, upkeep, all of it. Elfhosted is so freeing. It's an amazing service that I hope to be a member of for a long, long time!"

@Fingers91 (Discord)

"I would recommend ElfHosted to anyone. It has been great so far and made life a lot easier than running my own setups. If you’re in the fence give them a try and help support this great community."

Zestyclose_Teacher20 (Reddit)

"thanks for the help and must say this is the best host I every had for my server 🙂 10/10 🙂 All other places I have try have I got a lot buff etc. Your host can even give me full power on a 4K Remux on 200GB big movie file . That's damn awesome 😄"

@tjelite (Discord)

"What an amazing support system these guys have Chris and Layzee i think it was! Both are very patient with me even though I am a newbie at all this. Very thorough and explained everything step by step with me

I couldn’t ask for anything better than the service I have received by these guys! Happy happy client❤️"

@dead.potahto (Discord)

"Very happy customer. Great service"

@ronney67 (Discord)

"Very good customer service, frequent updates, and excelent uptime!!!!!"

@ed.guim (Discord)

"I had my own plex-arrs setup on hetzner for years. Yesterday I deleted everything as elfhosted has gone above and beyond it. And it has a fantastic, active community as well! Very friendly, helpful and like-minded folks always willing to help and improve the system. Top notch!"

@alon.hearter (Discord)

"Absolutely Amazed with the patience and professionalism of all Elf-Venger Staff including bossman penguin❤️"

@dead.potahto (Discord)

"@BSM went above and beyond to make sure I had all the one on one support needed with my sub. Thank you for your patience! Elfhosted continues to be Elftastic !!"

@bfmc1 (Discord)

"really enjoying the service from elfhosted. The setup is really easy from the guides on the website. And the help on the discord channel is really quick."

@jrhd13 (Discord)