Installing Sniffly
Sniffly is a fast, visual disk space analyzer built with Fortran and GTK4.
Installation Methods
Option 1: Download DMG (Recommended)
- Download the latest release: Sniffly-0.2.4-macOS.dmg
- Open the DMG
- Drag
Sniffly.appto your Applications folder - First launch: Right-click Sniffly → "Open" → Click "Open" again to bypass Gatekeeper
Option 2: Homebrew (For Brew Users)
# Install Sniffly (once we publish the cask)
# No dependencies needed - everything is bundled!
brew install --cask sniffly
Option 3: Build from Source
# Install dependencies
brew install gtk4 gtk-4-fortran meson
# Clone and build
git clone https://github.com/FortranGoingOnForty/sniffly.git
cd sniffly
meson setup build --buildtype=release
meson compile -C build
# Run
./build/sniffly
System Requirements
- macOS 11.0 or later
- Apple Silicon or Intel Mac
Usage
Launch from Applications
Double-click Sniffly in your Applications folder.
Launch from Terminal
# Scan your home directory (default)
/Applications/Sniffly.app/Contents/MacOS/sniffly
# Scan a specific directory
/Applications/Sniffly.app/Contents/MacOS/sniffly ~/Documents
# Show help
/Applications/Sniffly.app/Contents/MacOS/sniffly --help
# Show version
/Applications/Sniffly.app/Contents/MacOS/sniffly --version
Troubleshooting
"Sniffly is damaged and can't be opened"
This happens because the app isn't signed with an Apple Developer certificate. To bypass:
Method 1: Right-click to open
- Right-click (or Control-click) Sniffly.app
- Click "Open"
- Click "Open" again in the dialog
Method 2: Remove quarantine attribute
xattr -cr /Applications/Sniffly.app
Window doesn't appear
If Sniffly starts but no window appears, try running from terminal to see debug output:
/Applications/Sniffly.app/Contents/MacOS/sniffly ~/Downloads
Uninstalling
DMG Installation
rm -rf /Applications/Sniffly.app
rm ~/Library/Logs/Sniffly.log
Homebrew Installation
brew uninstall --cask sniffly
View source
| 1 | # Installing Sniffly |
| 2 | |
| 3 | Sniffly is a fast, visual disk space analyzer built with Fortran and GTK4. |
| 4 | |
| 5 | ## Installation Methods |
| 6 | |
| 7 | ### Option 1: Download DMG (Recommended) |
| 8 | |
| 9 | 1. Download the latest release: [Sniffly-0.2.4-macOS.dmg](https://github.com/FortranGoingOnForty/sniffly/releases/latest) |
| 10 | 2. Open the DMG |
| 11 | 3. Drag `Sniffly.app` to your Applications folder |
| 12 | 4. **First launch:** Right-click Sniffly → "Open" → Click "Open" again to bypass Gatekeeper |
| 13 | |
| 14 | ### Option 2: Homebrew (For Brew Users) |
| 15 | |
| 16 | ```bash |
| 17 | # Install Sniffly (once we publish the cask) |
| 18 | # No dependencies needed - everything is bundled! |
| 19 | brew install --cask sniffly |
| 20 | ``` |
| 21 | |
| 22 | ### Option 3: Build from Source |
| 23 | |
| 24 | ```bash |
| 25 | # Install dependencies |
| 26 | brew install gtk4 gtk-4-fortran meson |
| 27 | |
| 28 | # Clone and build |
| 29 | git clone https://github.com/FortranGoingOnForty/sniffly.git |
| 30 | cd sniffly |
| 31 | meson setup build --buildtype=release |
| 32 | meson compile -C build |
| 33 | |
| 34 | # Run |
| 35 | ./build/sniffly |
| 36 | ``` |
| 37 | |
| 38 | ## System Requirements |
| 39 | |
| 40 | - macOS 11.0 or later |
| 41 | - Apple Silicon or Intel Mac |
| 42 | |
| 43 | ## Usage |
| 44 | |
| 45 | ### Launch from Applications |
| 46 | Double-click Sniffly in your Applications folder. |
| 47 | |
| 48 | ### Launch from Terminal |
| 49 | ```bash |
| 50 | # Scan your home directory (default) |
| 51 | /Applications/Sniffly.app/Contents/MacOS/sniffly |
| 52 | |
| 53 | # Scan a specific directory |
| 54 | /Applications/Sniffly.app/Contents/MacOS/sniffly ~/Documents |
| 55 | |
| 56 | # Show help |
| 57 | /Applications/Sniffly.app/Contents/MacOS/sniffly --help |
| 58 | |
| 59 | # Show version |
| 60 | /Applications/Sniffly.app/Contents/MacOS/sniffly --version |
| 61 | ``` |
| 62 | |
| 63 | ## Troubleshooting |
| 64 | |
| 65 | ### "Sniffly is damaged and can't be opened" |
| 66 | |
| 67 | This happens because the app isn't signed with an Apple Developer certificate. To bypass: |
| 68 | |
| 69 | **Method 1: Right-click to open** |
| 70 | 1. Right-click (or Control-click) Sniffly.app |
| 71 | 2. Click "Open" |
| 72 | 3. Click "Open" again in the dialog |
| 73 | |
| 74 | **Method 2: Remove quarantine attribute** |
| 75 | ```bash |
| 76 | xattr -cr /Applications/Sniffly.app |
| 77 | ``` |
| 78 | |
| 79 | ### Window doesn't appear |
| 80 | |
| 81 | If Sniffly starts but no window appears, try running from terminal to see debug output: |
| 82 | ```bash |
| 83 | /Applications/Sniffly.app/Contents/MacOS/sniffly ~/Downloads |
| 84 | ``` |
| 85 | |
| 86 | ## Uninstalling |
| 87 | |
| 88 | ### DMG Installation |
| 89 | ```bash |
| 90 | rm -rf /Applications/Sniffly.app |
| 91 | rm ~/Library/Logs/Sniffly.log |
| 92 | ``` |
| 93 | |
| 94 | ### Homebrew Installation |
| 95 | ```bash |
| 96 | brew uninstall --cask sniffly |
| 97 | ``` |