whatisgithub

What is filament?

akshaymaloo/filament — explained in plain English

Analysis updated 2026-05-18

7SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

Filament is a native macOS app that gives 3D printing files like 3MF, STL, OBJ, and PLY real Finder thumbnails and interactive space bar previews.

Mindmap

mindmap
  root((filament))
    What it does
      Finder thumbnails
      Space bar previews
      Multi-plate 3MF support
    Tech stack
      Swift
      SwiftUI
      SceneKit
    Use cases
      Preview 3D print files
      Check build plates
      Browse model folders
    Audience
      3D printing hobbyists
      Mac users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Preview a downloaded 3MF or STL model in Finder before opening a slicer program.

USE CASE 2

Check a multi-plate Bambu Studio or OrcaSlicer project's build plates and print stats at a glance.

USE CASE 3

Browse a folder of 3D model files with real thumbnails instead of generic file icons.

USE CASE 4

Set Filament as the default macOS app for opening 3MF and STL files.

What is it built with?

SwiftSwiftUISceneKitXcodeGen

How does it compare?

akshaymaloo/filamentcrafcat7/peakmonmotemen/macos-bluetoothaudiodistancer
Stars777
LanguageSwiftSwiftSwift
Last pushed2020-12-25
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/53/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Building from source requires Xcode and XcodeGen, the app itself installs with one script and needs macOS 14 or later.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Filament is a native macOS app that adds proper thumbnails and interactive previews for 3D printing files, so you can select a model file in Finder, press the space bar, and see it spin in three dimensions without opening a slicer program first. It supports the common 3D printing and modeling formats: 3MF, including multi plate Bambu Studio and OrcaSlicer project files, along with STL, OBJ, and PLY. The app generates near instant thumbnails in Finder, using the slicer's own embedded plate image for 3MF files and rendering the others on the fly. Pressing space opens an interactive preview where you can orbit, pan, and zoom the model under soft studio style lighting. For 3MF files that use multiple filament colors, Filament renders the model in its real slicer colors, with an option to switch to a plain neutral look instead, and if a 3MF project has several build plates you can browse between them. It also shows basic model information such as dimensions in millimeters and triangle count, plus print time, weight, and printer details when a 3MF file includes them. Double clicking or dragging a supported file opens it in the full Filament window, and the app is built to open very large, multi million triangle files in about a second thanks to a dedicated streaming parser. It runs entirely offline with no network access or telemetry. To use it you need macOS 14 Sonoma or later. Building it from source requires Xcode and a tool called XcodeGen, and an included install script handles checking prerequisites, building a release version, signing it so it can run locally with just a free Apple ID, and registering it as the default viewer for 3MF and STL files. The project is organized as a dependency-free Swift library that does the actual file parsing and 3D scene building, a SwiftUI app that hosts the viewer, and two small Finder extensions that provide the thumbnails and the space bar preview. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me build and install this macOS app using its install.sh script and a free Apple ID for signing.
Prompt 2
Explain how to set up code signing for the Filament, ThumbnailExtension, and PreviewExtension targets in Xcode.
Prompt 3
Walk me through generating the Xcode project from project.yml with XcodeGen.
Prompt 4
Show me how the ThreeMFKit Swift package parses 3MF files without any external dependencies.

Frequently asked questions

What is filament?

Filament is a native macOS app that gives 3D printing files like 3MF, STL, OBJ, and PLY real Finder thumbnails and interactive space bar previews.

What language is filament written in?

Mainly Swift. The stack also includes Swift, SwiftUI, SceneKit.

What license does filament use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is filament to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is filament for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.