@naamiru/eagle-webui
v2.1.1
Published
A web interface for Eagle image viewer - browse your Eagle library from any device
Downloads
30
Maintainers
Readme
Eagle WebUI
A web interface for the Eagle image viewer application.
[!NOTE] Looking for an iOS app? Check out Eagle Viewer for iOS - a native iPhone app for viewing your Eagle library.
Screenshots


Features
- Read-only viewer that won't modify your library, or consume extra storage
- Responsive UI for desktop and mobile
- Multi-language support in English, Japanese, Korean, and Chinese (Simplified/Traditional)
- Simple one-command setup
Requirements
- Node.js >= 18.18.0
- Eagle app 4.x
Installation and Usage
Make sure the Eagle app is running on the same machine, then run:
npx @naamiru/eagle-webuiThen open http://localhost:34917/ in your browser.
Accessing from Other Devices
Make the interface reachable from other devices on your network:
npx @naamiru/eagle-webui --hostname 0.0.0.0After running this command, open http://<your-computer's-LAN-IP>:34917/ from each device.
⚠️ Security Warning: This application serves images without authentication. Do not expose it to public networks. If you need remote access, I recommend using a VPN—services like Tailscale could help.
Command-line Options
| Option | Description |
| ---------------------- | ----------------------------------------------------------------------------------- |
| --hostname | Bind server to a specific hostname or IP address (default: localhost) |
| --port | Server port number (default: 34917) |
| --eagle-library-path | Path to the Eagle library folder (if omitted, detected automatically via Eagle API) |
| --eagle-api-url | Eagle API endpoint for library detection (default: http://localhost:41595) |
