Important: For optimal compatibility with 3D model preview and asset loading, please follow these guidelines.

• Use ASCII characters for file and folder names
• Use hyphens - or underscores _ instead of spaces
• Keep paths short and simple
• Place texture files in the same directory as the model file

Good Examples:

/Projects/my-game/models/character_model.fbx
/Projects/my-game/textures/diffuse_map.png

Some 3D model formats (FBX, OBJ, DAE) embed texture paths internally. When these paths contain special characters, the Tauri asset protocol may not resolve them correctly. This is a known platform limitation.

• Fast async scanning with real-time progress and cancellation
• Project type detection — Unity, Unreal, Godot, or generic
• Directory tree visualization with file counts and sizes
• Unity .meta file parsing — extracts GUIDs for asset tracking

• Create custom color-coded tags
• Tag single or multiple assets at once
• Filter assets by tags (single or multi-select)
• Tags persist across sessions

• Thumbnail preview with disk caching
• Virtual scrolling — handles 10,000+ files smoothly
• Search by filename or path
• Filter by asset type
• 3D model preview with orbit controls

image · gltf · tobj · symphonia · sha2 · walkdir · toml · git2 · rayon

• Node.js 18+
• pnpm 8+
• Rust 1.75+

# Clone repository
git clone https://github.com/AquaStarfish/Tidycraft.git
cd tidycraft

# Install dependencies
pnpm install

# Run in development mode
pnpm tauri dev

# Build for production
pnpm tauri build

1. Open Project — Click "Open Project" and select your game project folder
2. Browse Assets — Navigate the directory tree, search, and filter
3. Preview Assets — Click any asset to view details and preview
4. Tag Assets — Right-click to add tags for organization
5. Run Analysis — Click "Run Analysis" to check for issues
6. Review Issues — Switch to Issues tab to see problems

Create a tidycraft.toml in your project root:

[naming]
check_forbidden_chars = true
forbidden_chars = ['<', '>', ':', '"', '|', '?', '*']
check_chinese = true
check_prefix = false
required_prefix = "tex_"

[texture]
check_pot = true
check_max_size = true
max_width = 4096
max_height = 4096

[model]
check_vertex_count = true
max_vertices = 100000
check_face_count = true
max_faces = 50000

[audio]
check_sample_rate = true
allowed_sample_rates = [44100, 48000]
check_duration = true
max_duration_secs = 300.0

[duplicate]
enabled = true

tidycraft/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── stores/             # Zustand state
│   ├── types/              # TypeScript types
│   └── lib/                # Utilities
├── src-tauri/              # Rust backend
│   └── src/
│       ├── scanner.rs      # Asset scanning
│       ├── analyzer.rs     # Rule engine
│       ├── thumbnail.rs    # Thumbnail generation
│       ├── tags.rs         # Tag management
│       └── lib.rs          # Tauri commands
└── docs/                   # Documentation

• Dependency analysis & reference tracking
• Statistics dashboard & reports
• Git integration (change detection)
• Incremental scanning
• Batch rename operations
• Custom rule scripting
• Export reports (JSON, CSV, HTML)

MIT