This build uses executable packing for protection, 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. If the issue persists, temporarily disable antivirus protection and try again.
Package Contents
After downloading and extracting the package, you will see two executable files in the folder: FilePulse is the main entry program, and FilePulseNative is the native application. If you only plan to use FilePulse through the browser, you may delete FilePulseNative.
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 the following commands to ensure all components have correct permissions (please ensure all commands below are executed):
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 FilePulseNative
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 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
1
Grant execution permissions
Open Terminal in the app directory and run:
chmod +x FilePulse FilePulseNative
2
Install dependencies
Run the following command in Terminal (Ubuntu/Debian):
It is recommended to start the application with root privileges to ensure all features work correctly:
sudo ./FilePulse
4
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."