atujii - Image Management Tool

Chinese Version

A clean and elegant local image management tool to help you easily manage and organize your images and video resources.

Image Management

Video Management

Main Features

Media Management

• Image Browsing - Supports grid view and list view
• Image Favorites - One-click to favorite images
• Image Classification - Flexible classification management system
• Media Import - Supports batch import of local images and videos
  • Folder import
  • Drag and drop import
• Media Search - Search by name and tags
• Video Support
  • Video preview and playback
  • Smart thumbnail generation
  • Mouse hover preview
  • Video timeline preview
• Batch Operations - Supports batch delete, classify, and other operations
• AI Tags - Supports automatic AI tagging for images

Classification Features

• Smart Classification - Built-in Recent, Images, Favorites, Videos, and other smart categories
• Custom Classification - Support creating, editing, and deleting custom categories
• Category Management - Support adding media to multiple categories
• Tag System - Support adding multiple tags to media

Interface Features

• Dual View Mode - Switch between grid view and list view
• Sorting Function - Sort by name, date, size
• Dark Theme - Auto-adapts to system dark mode
• Responsive Design - Perfect adaptation to various screen sizes
• Drag and Drop Support - Support drag and drop media file import
• Box Selection - Support box selection of multiple media files
• Custom Background Image

AI Features

• AI Auto-tagging - Use deep learning models to automatically identify image content and add tags
• ComfyUI Workflow - Support custom ComfyUI workflows for image processing
• Batch Processing - Support batch AI tag recognition
• Tag Management - Support editing and managing AI-generated tags

User Guide

For installation instructions, see install.en.md

Basic Operations

1. Browse Media

   • Switch View Mode: Click the grid/list icon in the toolbar
   • Sort: Click the sort button in the toolbar to choose sorting method
   • View Large Image: Double-click any media to enlarge
   • Video Preview: Hover mouse over video to preview, move mouse to quickly preview different timestamps
   • Filter: Use the filter button in the toolbar to filter by file type, size, date, and other conditions

2. Import Media

   • Click the "Import" button in the toolbar
   • Or directly drag and drop files into the application window
   • Supports common image formats like jpg, jpeg, png, gif
   • Supports video formats like mp4, mov, avi, webm

3. Manage Favorites

   • Click the heart icon in the top right of media to favorite/unfavorite
   • Click "Favorites" in the sidebar to view all favorited content

Category Management

1. Create Category

   • Click the "New Category" button at the bottom of the sidebar
   • Enter category name and confirm

2. Edit Category

   • Hover mouse over category to show edit button
   • Click edit button to modify category name
   • Click delete button to remove category

3. Add Media to Category

   • Select one or multiple media files
   • Click "Add to Category" button
   • Select target category to confirm addition

Batch Operations

1. Select Media

   • Click to select single media
   • Hold Shift and click to select a range
   • Hold mouse and drag in empty space to box select multiple media

2. Batch Operations

   • Batch operation toolbar appears after selecting media
   • Support batch delete
   • Support batch add to category
   • Support batch add tags

Using AI Features

1. AI Tags

   • Select one or multiple media files
   • Click "AI Tag" button in toolbar
   • Wait for AI to automatically recognize and add tags
   • Can manually edit and manage tags

2. ComfyUI Integration

   • Ensure ComfyUI is properly installed
   • Configure ComfyUI path in settings
   • Select media files to process
   • Choose preset workflow or import custom workflow
   • Execute processing

Tech Stack

• Electron - Cross-platform desktop application framework
• React - User interface building
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Atomic CSS framework
• Vite - Modern frontend build tool
• FFmpeg - Video processing
• Python - AI feature support
• ComfyUI - AI image processing

Development Guide

1. Install Dependencies

# Install Node.js dependencies
npm install

# Install Python dependencies
pip install -r requirements.txt

2. Run in Development Mode

npm run electron:dev

3. Build

npm run electron:build --win
npm run electron:build --mac
npm run electron:build --linux

Notes

• First run will create configuration file in user data directory
• Supported image formats: jpg, jpeg, png, gif
• Supported video formats: mp4, mov, avi, webm
• AI features require corresponding Python environment and dependencies
• ComfyUI features require proper ComfyUI environment configuration
• Recommended to regularly backup configuration file (images.json)

Future Plans

• Image tag system
• Video preview optimization
• Image information viewing
• Color classification support
• Multi-language support
• Shortcut key support
• Extensible plugin system
  • Image editing features
  • More AI model integration
• ComfyUI integration - Support image processing through ComfyUI

Contributing

Welcome to submit Issues and Pull Requests to help improve this project.

License

This project is licensed under the GNU General Public License v3.0.