Skip to content

Fe2-O3/HumDrop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HumDrop icon

HumDrop

Pull full 4K video and photos from your WiFi bird camera — straight to your computer.
No phone app. No cloud. No quality loss.

Latest Release  Platform  Python  License


The Problem

WiFi bird cameras like the Hibird 4K shoot gorgeous 4K footage, but the phone app only transfers downscaled 1080p clips. You're losing half your resolution every time.

The Solution

HumDrop connects directly to the camera over your local WiFi and pulls the original full-resolution files — 4K MP4 video and full-res JPG photos — straight from the SD card to your computer.


Install

macOS

  1. Open Terminal — press Cmd + Space, type Terminal, hit Enter
  2. 📋 Copy the command below and paste it into Terminal:
curl -sL https://github.com/Fe2-O3/HumDrop/releases/latest/download/HumDrop-macOS.zip -o /tmp/HumDrop.zip && unzip -o /tmp/HumDrop.zip -d /Applications && rm /tmp/HumDrop.zip && xattr -cr /Applications/HumDrop.app && open /Applications/HumDrop.app

Installs to Applications, removes the Gatekeeper quarantine flag, and opens the app. No security warnings.

Windows

  1. Open PowerShell — press Win + X, click Terminal or PowerShell
  2. 📋 Copy the command below and paste it into PowerShell:
curl.exe -sLo $env:TEMP\HumDrop.zip https://github.com/Fe2-O3/HumDrop/releases/latest/download/HumDrop-Windows.zip; New-Item -Force -ItemType Directory "$env:USERPROFILE\Desktop\HumDrop" | Out-Null; tar -xf $env:TEMP\HumDrop.zip -C "$env:USERPROFILE\Desktop\HumDrop"; Remove-Item $env:TEMP\HumDrop.zip; & "$env:USERPROFILE\Desktop\HumDrop\HumDrop.exe"

Installs to your Desktop and runs it. No SmartScreen warning (curl.exe + tar don't add the Mark of the Web).

Linux

  1. Open a terminal
  2. 📋 Copy the command below and paste it:
curl -sL https://github.com/Fe2-O3/HumDrop/releases/latest/download/HumDrop-Linux.tar.gz | tar -xz -C ~ && ~/HumDrop/HumDrop

Homebrew (macOS & Linux)

If you have Homebrew installed:

brew install Fe2-O3/tap/humdrop
humdrop

Don't have Homebrew? Install it first:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Direct Download

Platform Download
macOS HumDrop-macOS.zip (see first launch)
Windows HumDrop-Windows.zip (see first launch)
Linux HumDrop-Linux.tar.gz

Run from Source (all platforms)

git clone https://github.com/Fe2-O3/HumDrop.git
cd HumDrop/cross-platform
pip install -r requirements.txt
python humdrop.py

Features

Connect & Sync

  • Auto-discover cameras on your network, or enter IP manually
  • Download at full resolution — 4K MP4 video, full-res JPG photos
  • Live speed and ETA during transfers (MB/s, time remaining)
  • Smart sync — skips files you already have (size-based detection)
  • 5-second heartbeat monitors connection in real time
  • Disconnect handling — returns to home screen, updates status, sends system notification

Organize

Seven naming schemes with live preview in the dropdown:

Scheme Example
Custom · Date · Seq BirdCam_2026-01-31_001.mp4
Custom · Timestamp BIR_20260131_140144.mp4
Date · Time · Custom 2026-01-31_14-01_BirdCam.mp4
Date · Seq · Custom 2026-01-31_001_BirdCam.mp4
Custom · Seq BirdCam_001.mp4
Seq · Custom 001_BirdCam.mp4
Camera Original SCKR1000.mp4

Plus:

  • Underscore or space separator toggle
  • Custom prefix — name your files anything
  • Date subfolders — auto-sort into YYYY-MM-DD/ directories
  • Open folder when download finishes

Camera Storage

  • Visual storage bar — used/free/total with color-coded fill (teal → orange at 80% → red at 95%)
  • Persistent storage display — last-known data survives disconnect and app restart
  • Delete synced — remove only files you've already downloaded
  • Wipe all — clear entire camera with confirmation
  • Auto-delete — remove from camera immediately after each download

Presets & History

  • Camera and Settings Presets — save and switch between named configurations
  • Session history with timestamps — full log of downloads and deletes
  • Export to CSV for record-keeping

System Integration

  • Desktop notifications on download complete and connection loss (all platforms)
  • Persistent settings — naming scheme, prefix, separator, folder, storage data, and all options persist across launches
  • macOS TCC permissions — pre-configured for Desktop/Documents/Downloads folder access

Compatible Cameras

Camera Status
Hibird 4K Bird Camera with Solar Power Confirmed

Other Hibird/Camojojo bird cameras and trail cameras with similar firmware may also work.

Got a camera that works? Let us know.


First Launch

macOS — Gatekeeper warning (one-time, direct download only)

The app is not code-signed. On first launch:

  1. Double-click HumDrop.app — macOS will block it
  2. Open System Settings → Privacy & Security
  3. Scroll down and click "Open Anyway"
  4. Done — won't ask again

Or use Sentinel to remove the quarantine flag before opening — a free, open-source tool that makes managing unsigned apps easy.

Tip: Installing via the curl command or Homebrew avoids this entirely.

Windows — SmartScreen warning (one-time, direct download only)

Windows Defender SmartScreen may flag the executable (common for PyInstaller apps, not a real threat):

  1. Click "More info"
  2. Click "Run anyway"
  3. If your firewall prompts for network access, click Allow — HumDrop needs local network access to reach the camera

Tip: Installing via the PowerShell command above avoids this entirely.

Linux — no special steps

Requires a desktop environment (GNOME, KDE, Xfce, etc.). Notifications use notify-send if available.


Building from Source

cd cross-platform
pip install customtkinter pyinstaller

# macOS
pyinstaller --onedir --windowed --name HumDrop --icon HumDrop.icns \
  --osx-bundle-identifier com.fe2o3.humdrop --collect-all customtkinter humdrop.py

# Windows
pyinstaller --onedir --windowed --name HumDrop --collect-all customtkinter humdrop.py

# Linux
pyinstaller --onedir --windowed --name HumDrop --collect-all customtkinter humdrop.py

Automated builds run via GitHub Actions on every version tag — macOS, Windows, and Linux artifacts are attached to each release.


License

GPL-3.0 with Commons Clause — free to use, modify, and contribute; forks must stay open-source; cannot be sold.


Built for birders by Fe2-O3
If HumDrop helps you, consider buying me a coffee.

About

Native macOS utility for syncing videos/photos from WiFi-enabled trail and bird cameras. Downloads original 4K files directly from the camera.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors