Eagle Web Gallery

A web interface for remotely accessing your Eagle.cool library. Access, browse, and upload to your Eagle collection from any device with a web browser.

Screen.Recording.2025-09-24.174200.mp4

Features

Responsive Interface

• Responsive Design: Works on desktop, tablet, and mobile
• Dark/Light Mode: Automatic theme detection with manual toggle
• Masonry Layout: Eagle-style grid that adapts to screen size
• Modern UI: Built with Tailwind CSS

Easy Browsing

• Real-time Search: Find images with debounced search
• Tag Filtering: Click any tag to filter your collection
• Folder Filtering: Click any folder to filter your collection
• Shareable Links: URLs remember your filters, making it easy to bookmark or possibly share specific views

Remote Upload

• Secure Upload: PNG image upload with metadata removal (using ffmpeg)
• Direct Integration: Uploads go straight to your Eagle library
• Progress Feedback: Visual confirmation of uploads

Performance

• Lightweight: Binary less than 4MB (compressed with UPX)
• Fast: Direct integration with Eagle's native API
• Minimal Dependencies: Self-contained Go application
• Lazy Loading: Images load only when needed
• Pagination: Load more items as you scroll

Note: I don't foresee it being a problem, but currently, we load the [library]/images/[id]/*_thumbnail.png without any checks for size. Let me know your experience on data/metered networks if you have any problems by creating an issue

-> http://github.com/eissar/eagle-web/issues/new

Quick Start

Prerequisites

1. Eagle.cool must be installed and running

   • Download from eagle.cool
   • Ensure Eagle is running

2. FFmpeg (for image upload security)

   • Windows: Download from ffmpeg.org or install via Chocolatey: choco install ffmpeg
   • macOS: Install via Homebrew: brew install ffmpeg
   • Linux: Install via package manager: sudo apt install ffmpeg (Ubuntu/Debian)

   note: if you don't plan on uploading anything, you can skip installing this/ install it later.

Installation & Setup

1. Download the latest release from the releases page

2. Run the application:

   # Windows
   ./eagle-web.exe

3. Access the gallery:

   • Open your browser to http://localhost:8081/gallery / http://:8081/gallery
   • Start browsing your Eagle collection

Remote Access Setup

To access your Eagle library from other devices:

Option 1: Tailscale (Recommended)

Tailscale provides secure remote access:

1. Install Tailscale on the computer running Eagle Web:

   • Visit tailscale.com/download
   • Follow the setup instructions

2. Install Tailscale on your mobile device or remote computer

3. Access your gallery using your Tailscale IP:

   http://[your-tailscale-ip]:8081/gallery
   

Option 2: Cloudflare Tunnel

For more advanced users, Cloudflare Tunnel provides public access:

1. Install cloudflared
2. Set up a tunnel to localhost:8081
3. Access via your Cloudflare tunnel URL

Other options:

• Any other VPN/ Tunnelling solution
• Port Forwarding

Security Considerations

Important: This application provides no authentication or authorization. Anyone with access to the web interface can:

• View your entire Eagle library

• Upload new images

• Browse all tags and folders

• Use only on trusted networks or with a vpn

• Don't expose directly to the public internet

• see configuring for configuring the remote upload feature

Known Issues & Limitations

• Eagle Dependency: Eagle.cool must be running for the web interface to work
• API Reliability: Occasionally Eagle's API may become unresponsive I can't reproduce this yet, but sometimes the eagle api server will become unresponsive with no explanation. to solve this, the only solution I've found is to restart the actual app.
• Load Per Page: the load per page button does nothing

Roadmap

• Inspector: Inspector Side view for viewing all metadata
• MacOS/Linux hosting Support
• PWA Features: Progressive Web App with offline capabilities
• Mobile Share Integration: "Share to Eagle" from mobile browsers
• Bulk Operations: Multi-select and batch actions
• Extended File support: Support Non image item types

Configuring

• use --block-upload to block all uploads

• Environment Variables:

  • EAGLE_URL: Set the Eagle API URL (default: http://127.0.0.1:41595) warning: please keep in mind if your eagle library is hosted on another pc that the library files still need to be accessible to the running application so we can read thumbnails etc

Contributing

Please feel free to submit issues and pull requests. ( the html and styling is very disorganized )

Building Locally

TODO

Acknowledgments

• Eagle.cool for the asset management application
• HTMX for simplifying frontend interactivity
• Tailwind CSS for the CSS framework
• Heroicons for the icon set