[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80238":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":13,"lastSyncTime":27,"discoverSource":28},80238,"GyroidVault","TeeCodeDev\u002FGyroidVault","TeeCodeDev","Self-hosted 3D model library and print management platform.",null,"JavaScript",67,3,2,10,0,8,11,46.91,"Other",false,"main",true,[],"2026-06-12 04:01:27","# GyroidVault\n\n**GyroidVault** is a self-hosted 3D model library and print manager. It helps you organize your STL, 3MF, and Gcode files, keep track of your print history, and group files into project collections.\n\n![GyroidVault Dashboard](screenshots\u002FGyroidVault-Dashboard_page.png)\n\n> **⚠️ Early Release Notice:** GyroidVault is a brand-new project and still under active development. You may encounter bugs or rough edges. If you do, please [open an issue](https:\u002F\u002Fgithub.com\u002FTeeCodeDev\u002FGyroidVault\u002Fissues) — your feedback helps make GyroidVault better for everyone!\n\n## Screenshots\n\n\u003Ctable style=\"border: none; border-collapse: collapse;\">\n  \u003Ctr>\n    \u003Ctd style=\"padding: 5px; border: none;\">\u003Cimg src=\"screenshots\u002FGyroidVault-Models_page.png\" alt=\"Models Gallery\">\u003C\u002Ftd>\n    \u003Ctd style=\"padding: 5px; border: none;\">\u003Cimg src=\"screenshots\u002FGyroidVault-Collection_page.png\" alt=\"Collections Management\">\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd style=\"padding: 5px; border: none;\">\u003Cimg src=\"screenshots\u002FGyroidVault-Single_model_page.png\" alt=\"Model Detail View\">\u003C\u002Ftd>\n    \u003Ctd style=\"padding: 5px; border: none;\">\u003Cimg src=\"screenshots\u002FGyroidVault-Dashboard_page.png\" alt=\"Dashboard Statistics\">\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Features\n\n- **Dark\u002FLight Mode**: Toggle between dark and light themes depending on your preference.\n- **Batch Actions**: Select multiple models to move, delete, or add to collections at once.\n- **Folder Watching**: Automatically scan your local directories to import models, or upload them manually.\n- **Built-in 3D Viewer**: Preview STL and 3MF files directly in your browser.\n- **Collections**: Group related files together for multi-part projects.\n- **Model Versioning**: Track design iterations (v1, v2, final) under a single model entry.\n- **Print Log**: Keep a history of your prints, filament types used, and success rates.\n- **Public Share Links**: Generate secure, expiring links to share specific models with others.\n- **Slicer Integration**: Open files directly in Bambu Studio, PrusaSlicer, OrcaSlicer, or Elegoo Slicer.\n- **Multi-User & Roles**: Set up user accounts and admin controls to restrict access.\n\n## Quick Start (Docker Compose)\n\nThe easiest way to get GyroidVault running is using Docker Compose.\n\n1. **Create a file** named `docker-compose.yml`:\n    ```yaml\n    services:\n      gyroidvault:\n        image: ghcr.io\u002Fteecodedev\u002Fgyroidvault:latest\n        container_name: gyroidvault\n        ports:\n          - \"3457:3000\"\n        volumes:\n          - .\u002Fdata:\u002Fapp\u002Fdata\n          - \u002Fpath\u002Fto\u002Fyour\u002F3dprints:\u002Flibrary\n        environment:\n          - NODE_ENV=production\n          - PORT=3000\n          - LIBRARY_PATH=\u002Flibrary\n        restart: unless-stopped\n    ```\n\n2. **Configure your library**: Replace `\u002Fpath\u002Fto\u002Fyour\u002F3dprints` with the path on your host machine where your models are stored.\n\n3. **Start the container**:\n    ```bash\n    docker-compose up -d\n    ```\n\n4. **Open in browser**:\n    Go to [http:\u002F\u002Flocalhost:3457](http:\u002F\u002Flocalhost:3457) in your browser.\n\n## Initial Setup\n\n### 1. Registering the Admin\nThe very first person to register on a new GyroidVault instance automatically becomes the Administrator.\n- You do not need an invite code for the first registration.\n- If you are prompted for an invite code on a fresh install, make sure your `.\u002Fdata` directory is empty.\n\n### 2. Configuring SMTP (Email)\nTo enable password resets and user invitations, you need to configure SMTP:\n1. Log in as the **Administrator**.\n2. Go to **Settings** > **SMTP & Mail**.\n3. Enter your SMTP server details (Host, Port, User, Password).\n4. Save and test the configuration.\n\n## Manual Installation\n\n1. Install [Node.js](https:\u002F\u002Fnodejs.org\u002F) (v18+).\n2. Clone this repo and run `npm install`.\n3. Copy `.env.example` to `.env` and configure your settings.\n4. Run `npm start`.\n\n## Security & Privacy\n\n- **Local SQLite Database**: Your data stays on your own hardware. No external cloud database or telemetry is forced.\n- **Admin Control**: The first registered user automatically becomes the Admin. Invited users need token codes.\n- **File Management**: Uploaded files are kept locally in the database\u002Fuploads structure.\n\n## Troubleshooting & Support\n\n### Common Issues\n- **Viewer not loading**: Make sure your browser supports WebGL and that you are not using an ad-blocker that blocks Three.js components.\n- **File scanning issues**: Verify that your `LIBRARY_PATH` or the volume mapping in Docker is correct and that the app has read permissions for that directory.\n- **Slicer links not opening**: Make sure the slicer (Bambu Studio, etc.) is installed and has registered its URL scheme on your OS.\n\n### Support\n- **Unraid Users**: Please use the dedicated support thread on the Unraid Forums.\n- **General Issues**: Open an issue on [GitHub Issues](https:\u002F\u002Fgithub.com\u002FTeeCodeDev\u002FGyroidVault\u002Fissues).\n\n## License\n\nThis project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**. See the [LICENSE](LICENSE) file for details. This ensures that the software remains free and that improvements made by the community are shared back.\n\n---\n*Built for the 3D Printing Community.*\n\n*Note: Since English isn't my first language, I used AI to help write the documentation and structure the README. The application itself, the architecture, the UI, and the features are all my own, with AI helping me debug and iterate faster.*\n","GyroidVault 是一个自托管的3D模型库和打印管理平台，帮助用户组织STL、3MF和Gcode文件，跟踪打印历史，并将文件分组到项目集合中。其核心功能包括支持暗\u002F亮模式切换、批量操作、自动扫描本地目录导入模型、内置3D预览器、模型版本控制、打印日志记录以及生成安全分享链接等。此外，它还集成了多种切片软件，支持多用户角色管理。该工具适用于需要高效管理和共享3D打印资源的设计团队和个人爱好者。","2026-06-11 03:59:47","CREATED_QUERY"]