A Python and Tkinter-based WebODM client for batch management of projects and image stitching tasks in WebODM.
一个基于Python和Tkinter的WebODM客户端,用于批量管理WebODM中的项目和图片拼接任务。
- User Authentication: Connect to WebODM server and authenticate
- Project Management: View, create, and manage WebODM projects
- Task Management: Create, view, and manage tasks within selected projects
- Batch Operations: Support for batch operations on multiple tasks, such as downloading assets, restarting/canceling/deleting tasks
- Preset-Based Parameters: Load presets from
/api/presets/; both task creation and restart send only preset options - Background Uploads: Image uploads run in the background and auto commit; non-blocking UI
- Integrated Progress UI: Upload progress is shown inside the New Task dialog; the dialog can be minimized
- Multiple New Task Dialogs: Support opening multiple New Task dialogs concurrently, each with independent progress
- Credential Caching: Cache username and password to the local config for faster login (see Security Notes)
- Python 3.6+
- Dependencies: requests, tkinter, pillow, etc.
- Clone or download this repository
- Install dependencies:
pip install -r requirements.txt- Run the main program:
python main.py- Enter the WebODM server address in the interface (default is http://localhost:8000)
- Click the "Login" button and enter your username and password (credentials will be cached locally after a successful login)
- After successful login, you can view and manage projects and tasks
- View Project List: Automatically loads the project list after login
- Create New Project: Click the "New Project" button and enter the project name and description
- Select Project: Click on a project in the project list to load its task list
- View Task List: Automatically loads the task list after selecting a project
- Create New Task: Click the "New Task" button, select image files, choose a preset, and start. Uploads run in the background and will auto-commit. Upload progress is displayed inside the dialog, which can be minimized. You can open multiple New Task dialogs to run uploads concurrently.
- View Task Details: Double-click on a task in the task list to view detailed information
- Download Assets: Select one or more tasks, click the "Download Assets" button, choose the asset types to download and the save directory
- Restart Tasks: Select one or more tasks, click the "Restart Tasks" button and select a preset. Only preset options are sent.
- Cancel Tasks: Select one or more tasks, click the "Cancel Tasks" button to cancel pending or in-progress tasks
- Delete Tasks: Select one or more tasks, click the "Delete Tasks" button to delete the selected tasks
The program creates a .webodm_client folder in the user's home directory to store configuration information, including server address, authentication token, and cached credentials (username and password) to streamline future logins.
- Credential caching is enabled for convenience. If you prefer not to cache passwords, disable or remove the stored
passwordin the config file.
- This client needs to connect to a running WebODM server
- The default server address is http://localhost:8000, which can be modified in the interface
- Downloading large asset files may take a long time, please ensure you have enough disk space