Skip to content

aaronmichaelfrost/Linuxify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Linuxify

Audit your Unity project for Linux dedicated-server build compatibility.

Electron Platform License

Linuxify scans your Unity project and flags issues that will break or cause problems when building dedicated servers for Linux — especially when your workflow has been Windows-only.

Point it at your Unity project folder, and in seconds you get a categorized report of every issue that needs fixing before your Linux build will work.

Linuxify Preview


Quick start

Option A — Download and run (no install required)

  1. Go to Releases
  2. Download Linuxify-Portable.exe (no install needed, just run it)
  3. Or download Linuxify.Setup.exe to install with a Start Menu shortcut

Option B — Run from source

git clone https://github.com/<your-username>/Linuxify.git
cd Linuxify
npm install
npm start

Requires: Node.js 18+ and npm


What it checks

# Category What it detects
1 Build Module Whether Linux Standalone Support is referenced in ProjectSettings
2 Native Plugins .dll files under Plugins/ with no matching .so for Linux
3 Hardcoded Paths Windows drive-letter paths (e.g. C:\...) in C# scripts
4 Hardcoded .exe Literal .exe references (Linux executables have no extension)
5 Build Scripts Editor scripts calling BuildPipeline.BuildPlayer without StandaloneLinux64
6 Platform Guards #if UNITY_STANDALONE_WIN without Linux branches
7 Case Sensitivity Filenames differing only by case (fatal on Linux); backslashes in resource paths
8 Burst AOT Missing BurstAotSettings_StandaloneLinux64.json
9 Startup Scripts .bat files without .sh equivalents
10 Plugin Meta .dll.meta files targeting Windows without Linux platform settings
11 Windows APIs Registry, DllImport("kernel32"), Process.Start("cmd.exe") outside platform guards
12 StreamingAssets Backslash path concatenation, special characters in file names

Features

  • Clickable file paths — click any flagged file to open it in VS Code / Rider
  • Hide rows — dismiss resolved issues to focus on what's left
  • Filter by severity — show only errors, warnings, or info
  • Export — save the full report as CSV or text

Building from source

# Windows installer + portable exe
npm run dist:win

# Linux AppImage
npm run dist:linux

Output goes to the dist/ folder.

License

MIT

About

Audit your Unity project for Linux dedicated-server build compatibility

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors