Dust3D

Dust3D is a cross-platform 3D modeling software that makes it easy to create 3D models for video games, 3D printing, and more. It features built-in rigging, procedural animation and UV unwrapping, with export to GLB and FBX formats.

For more information, visit dust3d.org.

Getting Started

These instructions will get you a copy of Dust3D up and running on your local machine for development and testing purposes.

Prerequisites

• Qt 6 (recommended) or Qt 5, with the following modules: qtbase, qtsvg, qtmultimedia
• C++ compiler with C++17 support

Windows

1. Download and install the Qt Online Installer
2. Run the installer and choose the Qt 6 archives you want to install (required: qtbase, qtsvg, qtmultimedia)
3. Install Visual Studio 2022

macOS

1. Install Qt via Homebrew: brew install qt
2. Install Xcode Command Line Tools: xcode-select --install

Linux

1. Install Qt 6 using your distribution's package manager:
   • Ubuntu/Debian: sudo apt install qt6-base-dev qt6-svg-dev qt6-multimedia-dev libgl-dev
   • Fedora: sudo dnf install qt6-qtbase-devel qt6-qtsvg-devel qt6-qtmultimedia-devel

Building

1. Clone the repository

git clone https://github.com/huxingyi/dust3d.git

2. Build using qmake

Windows

1. Open the Qt Creator IDE
2. Select "Open Project" from the File menu
3. Navigate to the project directory dust3d/application and open the .pro file
4. Select the desired build configuration (e.g. Debug or Release) from the dropdown menu at the bottom left of the window
5. Click the "Run" button to build and run the project

macOS / Linux

1. Change to the project directory dust3d/application
2. Run qmake to generate a Makefile
3. Build the project using make

Releasing

1. Make sure all changes are merged to master branch including CHANGELOGS update
2. Run git tag <version> (e.g. git tag 1.1.0)
3. Run git push origin <version>
4. Wait for Actions/release to finish and download all the Artifacts
5. Go to Tags/<version> and create release from tag
6. Title the release as <version>
7. Copy description from CHANGELOGS
8. Drag the Artifacts to binaries: Dust3D-win32-x86_64.zip, Dust3D-x86_64.AppImage, Dust3D.dmg
9. Publish release

License

Dust3D is licensed under the MIT License - see the LICENSE file for details.