How b1t0nese/maclearn works
MacLearn is a desktop application for collecting internet images and preparing labeled image datasets. A user opens or creates a project in the Qt interface; the application manages project data and can run automated collection through Chrome and an image source. Collected images are processed and stored with project metadata, then prepared for export. The README also documents augmentation, annotation, dataset statistics, and logging. These capabilities are represented where their implementing modules are known; some finer relationships are not established by the sampled excerpts.
Main entry points: main.py Application controller · autodataset.py Collection workflow · project_manager.py Project storage · dataset_manager.py Dataset preparation
Components 15
Desktop application
- Application controller
src/main.py - Project interface
src/interface_module/window.py - Embedded program view
src/interface_module/embedded_program_qt.py - Log window
src/interface_module/logs_window.py
Image collection
- Collection workflow
src/autodataset_module/autodataset.py - Chrome browser
src/autodataset_module/browser.py - Image source registry
src/autodataset_module/sources/base.py - Yandex image search
src/autodataset_module/sources/yandex_images.py
Project and dataset
- Project storage
src/project_module/project_manager.py - Dataset preparation
src/project_module/dataset_manager.py
Processing and support
- Image processing
src/autodataset_module/photoshop.py - Platform utilities
src/pcfuncs.py - Logging
src/logger.py
Other components
- User
- Chrome
Connections 20
- User → Application controller: opens project
README.md - Application controller → Project interface: controls interface
src/main.py - Application controller → Project storage: opens project
src/main.py - Application controller → Dataset preparation: manages dataset
src/main.py - Application controller → Collection workflow: starts collection
src/main.py - Application controller → Log window: shows logs
src/main.py - Application controller → Project storage: gets statistics
src/main.py - Project interface → Embedded program view: uses view
src/interface_module/window.py - Collection workflow → Chrome browser: controls browser
src/autodataset_module/autodataset.py - Collection workflow → Image source registry: creates source
src/autodataset_module/autodataset.py - Image source registry → Chrome browser: uses browser
src/autodataset_module/sources/base.py - Yandex image search → Image source registry: implements source
src/autodataset_module/sources/yandex_images.py - Chrome browser → Chrome: drives
src/autodataset_module/browser.py - Collection workflow → Project storage: stores images
src/autodataset_module/autodataset.py - Collection workflow → Image processing: processes images
src/autodataset_module/autodataset.py - Dataset preparation → Project storage: reads project data
src/project_module/dataset_manager.py - Dataset preparation → Image processing: uses processing
src/project_module/dataset_manager.py - Collection workflow → Platform utilities: uses utilities
src/autodataset_module/autodataset.py - Collection workflow → Logging: logs activity
src/autodataset_module/autodataset.py - Logging → Platform utilities: uses utilities
src/logger.py