Skip to main content

​
Installation

LoFi Engine is available as a native desktop application for Linux, macOS, and Windows. A web version is also available for trying the app without installation.
LoFi Engine version 1.2.0 is the latest release. All desktop versions work completely offline after installation.

​
Quick install

Desktop app

Download for Linux, macOS, or Windows

Web version

Try instantly in your browser

​
Desktop installation

1

Download the installer

Visit the releases page and download the installer for your platform:

​
Linux

  • AppImage: Universal Linux binary (recommended)
  • .deb: For Debian/Ubuntu-based distributions
  • .rpm: For Fedora/RHEL-based distributions

​
macOS

  • .dmg: macOS disk image
  • .app: macOS application bundle
macOS users may need to allow the app in System Preferences > Security & Privacy on first launch.

​
Windows

  • .msi: Windows installer (recommended)
  • .exe: Portable executable
2

Install the application

​
Linux

AppImage:
chmod +x LofiEngine-*.AppImage
./LofiEngine-*.AppImage
Debian/Ubuntu (.deb):
sudo dpkg -i lofi-engine_*.deb
sudo apt-get install -f  # Install dependencies if needed
Fedora/RHEL (.rpm):
sudo rpm -i lofi-engine-*.rpm

​
macOS

  1. Open the downloaded .dmg file
  2. Drag LoFi Engine to your Applications folder
  3. Launch LoFi Engine from Applications
If macOS blocks the app, go to System Preferences > Security & Privacy and click “Open Anyway”.

​
Windows

  1. Run the .msi installer
  2. Follow the installation wizard
  3. Launch LoFi Engine from the Start Menu or Desktop shortcut
3

Launch LoFi Engine

Open the application from:
  • Linux: Application menu or terminal (lofi-engine)
  • macOS: Applications folder
  • Windows: Start Menu or Desktop shortcut
Press ESC after launching to view the info box with keyboard shortcuts and app information.

​
Web version

Try LoFi Engine instantly in your browser without installation:

LoFi Engine Web

Launch the web version at lofi-engine.vercel.app
The web version provides the same features as the desktop app but requires an internet connection and may have slightly different performance characteristics.

​
System requirements

​
Minimum requirements

  • OS: Linux, macOS 10.13+, Windows 10+
  • RAM: 2 GB
  • Disk space: 100 MB
  • Audio: Audio output device
  • OS: Latest version of your operating system
  • RAM: 4 GB or more
  • Audio: Quality headphones or speakers for best experience

​
Building from source

For developers who want to build LoFi Engine from source:

​
Prerequisites

1

Install dependencies

2

Clone the repository

git clone https://github.com/meel-hd/lofi-engine
cd lofi-engine
3

Install project dependencies

pnpm install
4

Run in development mode

pnpm tauri:d
This starts both the Vite dev server and Tauri development process.
5

Build for production

pnpm tauri:b
The built application will be in src-tauri/target/release.
For detailed development instructions and additional commands, see the project README.

​
Tech stack

LoFi Engine is built with:
  • Frontend: Svelte 3, TypeScript, Vite
  • Desktop framework: Tauri 2.0
  • Audio engine: Tone.js 14
  • Icons: Tabler Icons
  • Package manager: pnpm

​
Troubleshooting

​
App won’t launch

  • macOS: Check Security & Privacy settings and allow the app
  • Linux: Ensure the AppImage has execute permissions (chmod +x)
  • Windows: Run as administrator if installation fails

​
No audio output

  • Check your system audio settings
  • Ensure your audio device is properly connected
  • Try adjusting the volume controls in LoFi Engine

​
Performance issues

  • Close other resource-intensive applications
  • Try reducing the number of active ambient tracks
  • Consider using the Manual mode in Immersion settings

​
Next steps

Quick start guide

Learn how to generate your first LoFi track

Build docs developers (and LLMs) love

Get started for freeTalk to us