Version 2.0.1
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 the following commands to ensure all components have correct permissions (please ensure all commands below are executed):
xattr -dr com.apple.quarantine FilePulseNative.app
xattr -dr com.apple.quarantine FilePulse.app
chmod +x FilePulseNative.app/Contents/MacOS/app
chmod +x FilePulse.app/Contents/MacOS/FilePulse2. Allow in System Settings
If blocked: Open "System Settings" → "Privacy & Security" → Scroll to the bottom → Find FilePulse and click "Open Anyway".
Note: If you run the .app bundle with root privileges on macOS, the system tray icon will not be displayed due to OS limitations.
1. Grant execution permissions
Open Terminal in the app directory and run:
chmod +x FilePulse FilePulseNative2. 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:
#!/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."If you encounter issues while running the application, please try installing the following dependencies:
Grant execution permissions
Open Terminal in the app directory and run:
chmod +x FilePulse FilePulseNativeInstall 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:
#!/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."