-
Notifications
You must be signed in to change notification settings - Fork 106
Where Your Data Is Stored
Moonfin keeps a small amount of data on your device: the servers you've added, the profiles on each one, your settings, your sign-in tokens, and anything you've downloaded. This page says where each of those live per platform, and which of them survive uninstalling the app.
If you're only after download folders, Downloads covers those in more detail.
This is the usual surprise, and it isn't a bug. Your server list and the profiles under it are ordinary app settings, not secrets, so they sit in the same place as the rest of your preferences. Uninstalling is supposed to take that with it, and on most platforms it does. Three things bring it back:
- Android restores app data from backup. If your device backs up to Google Drive, reinstalling can restore Moonfin's settings along with it. You'll see your servers and profiles again, but you'll still have to sign in, because the sign-in token is encrypted with a key that never leaves the device and can't be restored.
- Desktop uninstallers leave your settings alone. On Windows and Linux, removing the app removes the program, not your configuration folder. This is deliberate and normal for desktop software, so a reinstall picks up exactly where you left off.
-
On macOS, dragging the app to the Trash leaves its container behind. The folder under
~/Library/Containersstays, and so does the sign-in token, which lives in your login keychain rather than inside the app.
On iOS and Apple TV, deleting the app does remove its data. If it comes back, it came from a device backup you restored, or the app was offloaded rather than deleted, which keeps its documents on purpose.
| What | Where it lives | Gone when you uninstall? |
|---|---|---|
| Servers and profiles | App settings store | Yes, unless restored from a backup |
| Settings and preferences | App settings store | Yes, unless restored from a backup |
| Sign-in tokens | Platform secure storage (keychain or keystore) | Yes, except on macOS |
| Offline database |
Moonfin/DB/offline.db in the documents folder |
Yes |
| Downloads | See Downloads | Yes |
| Saved store themes, cached images and messages |
themes/, images/ and messages/ beside the downloads |
Yes |
| Logs | Nothing on disk, they're held in memory only | Nothing to remove |
Diagnostic logs are never written to a file. They live in a buffer that's thrown away when the app closes, which is why Collecting Logs asks you to reproduce a problem before sending a report.
Android
The app id is org.moonfin.androidtv on both phone and TV builds. Beta builds use org.moonfin.androidtv.beta and keep entirely separate data.
| What | Path |
|---|---|
| Servers, profiles, settings | /data/data/org.moonfin.androidtv/shared_prefs/FlutterSharedPreferences.xml |
| Sign-in tokens |
/data/data/org.moonfin.androidtv/shared_prefs/FlutterSecureStorage.xml, encrypted with an Android Keystore key |
| Offline database | Android/data/org.moonfin.androidtv/files/Moonfin/DB/offline.db |
| Downloads, themes, images | under Android/data/org.moonfin.androidtv/files/Moonfin/
|
The /data/data paths are private app storage and you can't browse to them without root. To clear them, use Settings > Apps > Moonfin > Storage > Clear storage, which wipes everything in one go.
Moonfin doesn't declare any backup rules of its own, so Android's default applies and your settings can be included in a device backup. That's what makes a reinstall remember your servers.
iOS and Apple TV
The bundle id is org.moonfin.app. Everything sits inside the app's sandbox container, so deleting the app removes all of it.
| What | Path inside the container |
|---|---|
| Servers, profiles, settings | Library/Preferences/org.moonfin.app.plist |
| Sign-in tokens | the system keychain |
| Offline database | Documents/Moonfin/DB/offline.db |
| Downloads |
Documents/Moonfin/ on iOS |
On Apple TV downloads go to the app's cache directory instead, which the system may reclaim when storage runs low.
Because the iOS files live in Documents, they're included in iCloud and device backups. Restoring a backup brings them back. Offload App also keeps documents on purpose so that reinstalling restores your content, so use Delete App if you want a clean slate.
macOS
The bundle id is org.moonfin.app and the app is sandboxed, so its data lives in a container rather than directly in your Library.
| What | Path |
|---|---|
| Servers, profiles, settings | ~/Library/Containers/org.moonfin.app/Data/Library/Preferences/org.moonfin.app.plist |
| Offline database | ~/Library/Containers/org.moonfin.app/Data/Documents/Moonfin/DB/offline.db |
| Downloads, themes, images | ~/Library/Containers/org.moonfin.app/Data/Library/Application Support/org.moonfin.app/ |
| Sign-in tokens | your login keychain, ~/Library/Keychains/login.keychain-db
|
macOS is the one platform where tokens outlive the app. Moonfin stores them in the file based login keychain because the newer data protection keychain refuses writes from an app without a keychain access group, which would mean signing in again on every launch. The trade-off is that the tokens stay in your keychain after the app is gone.
To remove everything, delete the app, then delete ~/Library/Containers/org.moonfin.app. To clear the tokens as well, open Keychain Access, search for moonfin, and delete what it finds.
Windows
| What | Path |
|---|---|
| Servers, profiles, settings | %APPDATA%\org.moonfin\Moonfin\shared_preferences.json |
| Sign-in tokens | Windows Credential Manager |
| Offline database | %USERPROFILE%\Documents\Moonfin\DB\offline.db |
| Downloads, themes, images |
%APPDATA%\org.moonfin\Moonfin\Downloads\ by default, or wherever you pointed it |
%APPDATA% is C:\Users\YourName\AppData\Roaming. Uninstalling leaves this folder in place. Delete %APPDATA%\org.moonfin by hand for a clean start.
Linux
| What | Path |
|---|---|
| Servers, profiles, settings | ~/.local/share/org.moonfin.linux/shared_preferences.json |
| Sign-in tokens | your desktop keyring, through libsecret |
| Offline database | ~/Documents/Moonfin/DB/offline.db |
| Downloads, themes, images |
~/.local/share/org.moonfin.linux/Downloads/ by default, or wherever you pointed it |
Older installs may use ~/.local/share/moonfin instead, and Moonfin keeps using that folder if it already exists. Check both. Removing the package leaves either one in place, so delete it yourself if you want the app to forget everything.
Web
The browser build keeps servers, profiles, settings and tokens in local storage for the site, and the offline database in IndexedDB under the name moonfin_offline.
Clearing site data for the page removes all of it. A private or incognito window starts empty and keeps nothing after you close it.
From inside the app:
- Remove one server. On the server select screen, press and hold a server and choose Remove server. This forgets the server and the profiles saved against it.
- Remove everything. Open the user menu and choose Sign out all users. This signs out and removes every saved server and profile.
Neither of these deletes your downloads, and neither clears the stored sign-in tokens. The tokens are keyed per server and are harmless once the server is gone, but if you want them gone too, clear the app's data using the platform steps above.
For a genuinely clean slate, uninstall and then delete the folder listed for your platform. On Android, turning off backup for Moonfin before you reinstall stops your old settings coming back.
Using Moonfin
Going deeper
For developers