Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eyhn/space-thumbnails

Generates preview thumbnails for 3D model files. Provide a Windows Explorer extensions that adds preview thumbnails for 3D model files.
https://github.com/eyhn/space-thumbnails

3d explorer preview rust thumbnails

Last synced: 19 days ago
JSON representation

Generates preview thumbnails for 3D model files. Provide a Windows Explorer extensions that adds preview thumbnails for 3D model files.

Host: GitHub
URL: https://github.com/eyhn/space-thumbnails
Owner: EYHN
License: apache-2.0
Created: 2022-04-09T01:48:28.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2022-04-26T03:51:42.000Z (over 2 years ago)
Last Synced: 2024-10-13T15:25:20.869Z (about 1 month ago)
Topics: 3d, explorer, preview, rust, thumbnails
Language: Rust
Homepage:
Size: 15.2 MB
Stars: 374
Watchers: 6
Forks: 17
Open Issues: 15
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Space Thumbnails

Generates preview thumbnails for 3D model files. Provide a Windows Explorer extensions that adds preview thumbnails for 3D model files.

[![](https://img.shields.io/github/downloads/eyhn/space-thumbnails/total)](https://github.com/EYHN/space-thumbnails/releases)

![screenshot](./screenshot.png)

## Supported formats

- Wavefront Object (`.obj`)
- FBX-Format, as ASCII and binary (`.fbx`)
- Stereolithography (`.stl`)
- Collada (`.dae`)
- Stanford Polygon Library (`.ply`)
- glTF2.0 (`.glb`/`.glTF`)
- Extensible 3D (`.x3d`/`.x3db`)
- 3D Studio Max 3DS (`.3ds`)

## Windows Explorer Extensions

#### **[Download From Github Release](https://github.com/EYHN/space-thumbnails/releases)**

[![](https://img.shields.io/github/v/release/eyhn/space-thumbnails?display_name=tag&sort=semver)](https://github.com/EYHN/space-thumbnails/releases)

### No thumbnails showing

**Ensure thumbnails are generally enabled.** Are thumbnails working with other file types on your system, e.g. photos? If not, you may have disabled them altogether.

1. open any folder
2. open the `Folder Options`

- Windows 10: select `View` → `Options` → `Change folder and search options`

- Windows 7: select `Organize` → `Folder and search options`

3. Select the `View` tab
4. in `Advanced settings`, make sure the `Always show icons, never thumbnails` option is not checked

**Clear your thumbnail cache.** This forces Explorer to request new thumbnails instead of relying on outdated data.

1. click the `Start` button and type `cleanmgr.exe`
2. select drive `C:` and confirm
3. check `Thumbnails` and confirm
4. reboot

### Speed

Rendering thumbnails for 3D models may not be that fast. To keep your explorer smooth and available, we have made some limits here, if the model file size is larger than `300MB` or takes longer than `5 seconds` to load and render, it will be cancelled and display this image below.

If there is an error loading the file (corrupt or illegal file), it will display this image below.

### Logs

Space Thumbnails saving the logs in `Windows Events`. To view the logs, you can open `Event Viewer`, right-click on the `Custom Views` folder in the left Console Tree, click `Create Custom View...`. and follow the steps below to create a custom view. You need to upload the logs here when you submit the issue.

![](event-viewer.png)

## Links

- [google / filament](https://github.com/google/filament): 3D rendering engine, and [the rust bindings](https://github.com/EYHN/rust-filament)
- [assimp](https://github.com/assimp/assimp): Asset import library, provides support for 3D file formats.
- Thanks to @Shomnipotence for the icon design.

## License

Please see [LICENSE](./LICENSE).