Which edition should I choose?

Most users should choose Desktop. Choose Server only for headless servers or deployments where FilePulse will be accessed through a browser.

Packaged or Standard?

On macOS and Linux, most users should choose Packaged (.app/AppImage) for easier launch. Choose Standard when you need a single FilePulse executable for command-line use, scripts, or server-style deployment.

Security Software Notice

Release packages use security protection measures, which may trigger false positives or blocking in some antivirus products. If the download or launch is blocked, please add the app or its folder to your whitelist or trusted list.

Package Contents

Each package exposes one user-facing entry named FilePulse: FilePulse.exe on Windows, FilePulse for standard macOS/Linux packages, FilePulse.app for macOS app packages, or FilePulse.AppImage for Linux AppImage packages.

Platform not detected, please select below

All Downloads

Windows

x86_64 (Intel/AMD)

Desktop - Standard Server - Standard

ARM64

Desktop - Standard Server - Standard

macOS

Apple Silicon

Desktop - App Desktop - Standard Server - App Server - Standard

Intel (x86_64)

Desktop - App Desktop - Standard Server - App Server - Standard

macOS User Guide

macOS Gatekeeper may block apps downloaded from the internet. Please refer to the steps below based on your version:

.app Bundle Instructions

Recommendation: Move the app to another directory (e.g., /Applications) after downloading. Do not run it directly from the Downloads folder to avoid system blocks.

1. Remove quarantine attribute

Open Terminal in the app directory and run:

xattr -dr com.apple.quarantine FilePulse.app
chmod +x FilePulse.app/Contents/MacOS/*

2. Allow in System Settings

If blocked: Open "System Settings" → "Privacy & Security" → Scroll to the bottom → Find FilePulse and click "Open Anyway".

Standard Version Instructions

1. Grant execution permissions

Open Terminal in the app directory and run:

chmod +x FilePulse

2. Allow in System Settings

If blocked: Open "System Settings" → "Privacy & Security" → Click "Open Anyway".

3. Run with sudo

Run with sudo to ensure full functionality (including tray icon):

sudo ./FilePulse

4. Run in background with sudo

Use the following script to run in background (you need to enter your sudo password each time you run it):

#!/bin/bash

# 1. Enter target directory
cd ~/your_path || { echo "Directory not found"; exit 1; }

# 2. Request sudo permissions in advance
# This ensures the user enters the password once at the beginning, allowing nohup to run without interruption
echo "Requesting admin permissions to start FilePulse..."
sudo -v

# 3. Run in background
# nohup combined with & ensures the program runs in the background and persists after the terminal closes
sudo nohup ./FilePulse > /dev/null 2>&1 &

echo "FilePulse started in background."

Alternative: Auto-password script

This version stores password in script and runs without interactive sudo prompt:

#!/bin/bash

# --- Configuration ---
PASS="YOUR_PASSWORD_HERE"
# ---------------------

# 1. Enter target directory
cd ~/your_path || { echo "Directory not found"; exit 1; }

# 2. Provide password to sudo via standard input
# The -S flag tells sudo to read the password from stdin
echo "Automatically authenticating to start FilePulse..."
echo "$PASS" | sudo -S -v > /dev/null 2>&1

# 3. Run in background
# We pass the password again to ensure the nohup command executes as root
echo "$PASS" | sudo -S nohup ./FilePulse > /dev/null 2>&1 &

echo "FilePulse started in background."

Optional: To include macOS-protected folders such as Desktop, Documents, and Downloads in search, go to System Settings -> Privacy & Security -> Full Disk Access, then add and enable the app that launches FilePulse, either Terminal.app or FilePulse.app. FilePulse can still run without this permission, but files in those folders may not appear in search results.

Linux

x86_64

Desktop - AppImage Desktop - Standard Server - AppImage Server - Standard

arm64

Desktop - AppImage Desktop - Standard Server - AppImage Server - Standard

Having trouble opening on Linux?

Linux now provides both AppImage and standard builds. AppImage is recommended for quick launch; if you need the standard build, you can refer to the dependency and sudo instructions below.

AppImage Instructions

1. Grant execution permission

After extracting the zip, open Terminal in the folder containing the AppImage file and run:

chmod +x ./*.AppImage

2. Launch AppImage

If there is only one AppImage file in the current directory, you can start it directly with:

./*.AppImage

Standard Version Instructions

Grant execution permissions

Open Terminal in the app directory and run:

chmod +x FilePulse

Install dependencies

Run the following command in Terminal (Ubuntu/Debian):

sudo apt install -y libxdo3 libunwind-15 libayatana-appindicator3-1 libwebkit2gtk-4.1-0

Run with sudo

It is recommended to start the application with root privileges to ensure all features work correctly:

sudo ./FilePulse

Run in background with sudo

You can use the following script to start FilePulse with sudo and run it in the background without waiting. You need to enter your sudo password each time you run it:

#!/bin/bash

# 1. Enter target directory
cd ~/your_path || { echo "Directory not found"; exit 1; }

# 2. Request sudo permissions in advance
# This ensures the user enters the password once at the beginning, allowing nohup to run without interruption
echo "Requesting admin permissions to start FilePulse..."
sudo -v

# 3. Run in background
# nohup combined with & ensures the program runs in the background and persists after the terminal closes
sudo nohup ./FilePulse > /dev/null 2>&1 &

echo "FilePulse started in background."

Alternative: Auto-password script

This version stores password in script and runs without interactive sudo prompt:

#!/bin/bash

# --- Configuration ---
PASS="YOUR_PASSWORD_HERE"
# ---------------------

# 1. Enter target directory
cd ~/your_path || { echo "Directory not found"; exit 1; }

# 2. Provide password to sudo via standard input
# The -S flag tells sudo to read the password from stdin
echo "Automatically authenticating to start FilePulse..."
echo "$PASS" | sudo -S -v > /dev/null 2>&1

# 3. Run in background
# We pass the password again to ensure the nohup command executes as root
echo "$PASS" | sudo -S nohup ./FilePulse > /dev/null 2>&1 &

echo "FilePulse started in background."

Back to Home