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.
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.
If blocked: Open "System Settings" → "Privacy & Security" → Scroll to the bottom → Find FilePulse and click "Open Anyway".
Executable 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 the executable with sudo to ensure full functionality (including the 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.
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."
Looking for a previous version?
Browse previous releases and their release notes on GitHub.
