Version 2.15.4
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.
Platform not detected, please select below
macOS Gatekeeper may block apps downloaded from the internet. Please refer to the steps below based on your version:
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".
1. Grant execution permissions
Open Terminal in the app directory and run:
chmod +x FilePulse2. 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 ./FilePulse4. 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.
FilePulse has been tested on Debian, Ubuntu, Arch Linux, and CachyOS, and works normally overall.
If you are using X11, both the AppImage and standard builds work normally, and all features are fully supported.
If you are using Wayland, we recommend the standard build. AppImage can still be used on Wayland, but due to known Wayland-side issues, double-click launching or enabling auto-start may cause the UI or startup process to hang. If you still prefer the AppImage build, do not launch it by double-clicking and do not enable auto-start. Instead, start it with: sudo ./FilePulse.AppImage
1. Grant execution permission
After extracting the zip, open Terminal in the folder containing the AppImage file and run:
chmod +x ./FilePulse.AppImage2. Launch AppImage
If there is only one AppImage file in the current directory, you can start it directly with:
sudo ./FilePulse.AppImageGrant execution permissions
Open Terminal in the app directory and run:
chmod +x FilePulseInstall dependencies
Run the following command in Terminal (Ubuntu/Debian):
sudo apt install -y libxdo3 libunwind-15 libayatana-appindicator3-1 libwebkit2gtk-4.1-0Run with sudo
It is recommended to start the application with root privileges to ensure all features work correctly:
sudo ./FilePulseRun 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."