1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
# Fluorine Manager
Fluorine Manager an attempt at porting [MO2 (Mod Organizer 2)](https://github.com/ModOrganizer2/modorganizer) to linux with FUSE as the VFS system.
NOTE: This is primarily for my personal use but I will see about fixing issues if I can. I use Claude/Codex, if you don't like AI please don't use this application. I'm looking for feedback not hate.
<img width="4134" height="2453" alt="image" src="https://github.com/user-attachments/assets/887e042a-db74-43f8-a5aa-735d18d94cc9" />
## Current Status
- Core app builds and runs on Linux.
- NaK integration is wired for game/proton detection and dependency handling.
- Linux-native game plugins (`libgame_*.so`) are supported.
- Portable instances are supported via local `ModOrganizer.ini` detection.
## FUSE Permissions
- Users only need to change `/etc/fuse.conf` when MO2 mounts with `allow_other` (or `allow_root`).
- If `allow_other` is used, uncomment `user_allow_other` in `/etc/fuse.conf` once (system-wide).
## Example
`#user_allow_other` to `user_allow_other` if its missing please add it.
## Installing and Running
Download the latest flatpak from the [releases](https://github.com/SulfurNitride/Fluorine-Manager/releases) and after you download it.
You are able to install it with this command: `flatpak install --user fluorine-manager.flatpak`
You can then get started with: `flatpak run com.fluorine.manager` or you should be able to find it in your apps drawer.
More information can be found in the [FAQ](https://github.com/SulfurNitride/Fluorine-Manager/blob/main/docs/FAQ.md).
You can find me in the [NaK Discord](https://discord.gg/9JWQzSeUWt)
If you want to support the things I put out, I do have a [Ko-Fi](https://ko-fi.com/sulfurnitride) I will never charge money for any of my content.
## Building
Both builds install to `~/.local/share/fluorine/` — the same location, so Flatpak and native share instances, plugins, and configs.
### Flatpak (recommended for end users)
```bash
./build-flatpak.sh bundle
# Produces a .flatpak file you can install with:
# flatpak install --user fluorine-manager.flatpak
```
### Native (container build)
Requires podman (or docker). The container handles all dependencies automatically.
```bash
./build-native.sh
# Builds inside a container, then installs to ~/.local/share/fluorine/
# Creates a desktop entry and symlinks fluorine-manager into ~/.local/bin/
```
### Native (building from source on host)
If you want to build directly on your system without a container, you need:
**Build tools:** GCC/Clang, CMake, Ninja, Rust toolchain, pkg-config, patchelf
**Libraries:**
- Qt 6 (base, webengine, websockets, wayland)
- Boost (program_options, thread)
- Python 3 dev headers, pybind11, PyQt6
- spdlog, toml++, tinyxml2, sqlite3, fontconfig
- libfuse3, lz4, zlib, zstd, bzip2, lzma
- OpenSSL, libcurl
**Python packages:** `sip` (build tools), `psutil`, `vdf`
Then build:
```bash
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_PLUGIN_PYTHON=ON
cmake --build build --parallel
```
Note: `python-sip` (the build tools package providing `sipbuild`) is required in addition to `python-pyqt6-sip` (the runtime module). If you see `ModuleNotFoundError: No module named 'sipbuild'`, install `python-sip`.
## Known Limitations
- Some third-party MO2 plugins are Windows-only and will fail on Linux (for example DLL/ctypes `windll` assumptions).
- Themes are currently not working as intended.
## Project Layout
```text
libs/ MO2 sub-libraries
src/ Main organizer source
docs/ Notes and tracking
```
|
