whatisgithub

What is decant?

kylebshr/decant — explained in plain English

Analysis updated 2026-05-18

20PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A command-line tool that extracts Apple's compiled Liquid Glass app icons from iOS and macOS 26 into editable files you can open in Icon Composer.

Mindmap

mindmap
  root((decant))
    What it does
      Reads compiled icons
      Recovers layers
      Exports editable bundle
    Tech stack
      Python
      Objective-C
      iOS Simulator
    Use cases
      Study Apple icon design
      Remix system icons
      Prep assets for Icon Composer
    Audience
      Mac developers
      Designers

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

Recover an editable version of one of Apple's built-in Liquid Glass icons

USE CASE 2

Inspect how a specific system icon's layers and effects are built

USE CASE 3

Prepare extracted icon assets to open and edit in Icon Composer

What is it built with?

PythonObjective-CXcodeiOS Simulator

How does it compare?

kylebshr/decantalex72-py/aria-termuxanime0t4ku/gentleman
Stars202020
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Xcode 26 and the iOS 26 simulator, some system icons need a device IPSW restore image.

So what is it?

Decant is a command-line tool for Mac developers and designers who want to inspect or recreate Apple's built-in app icons from iOS and macOS 26. Apple introduced a new icon style called Liquid Glass with that version, and the icons are stored in a compiled format that Apple's own Icon Composer design tool cannot open directly. Decant reads those compiled icons, recovers every layer and its rendering properties, and writes out an editable folder that Icon Composer can open. To use it, you need a Mac with Xcode 26 and an iOS 26 simulator installed. You run it from the command line with an app name (Maps, Photos, Safari) and it exports a .icon bundle to your current folder. Most system apps are available from the simulator, a handful (App Store, Podcasts) were excluded by Apple and require a device restore image called an IPSW. The README explains how to mount one and point decant at it. The extraction captures each icon's layers: vector and raster artwork, blend modes, opacity, glass and translucency effects, shadows, specular highlights, and per-appearance settings for light, dark, and tinted display modes. Every result is verified by recompiling with Apple's actool and comparing against the original until the values match exactly, which the README calls round-trip calibration. The tool is written in Python with a small Objective-C extractor that runs inside the iOS 26 simulator. This is necessary because iOS 26 added new properties to the icon format (refraction, specular placement) that can only be read back accurately from that environment. The extractor binary is compiled automatically on first run. Nothing from Apple's icon files is committed to the repository: the output icons folder is gitignored.

Copy-paste prompts

Prompt 1
Help me set up Xcode 26 and an iOS 26 simulator so I can run decant
Prompt 2
Walk me through mounting an IPSW so decant can extract App Store or Podcasts icons
Prompt 3
Explain what round-trip calibration means in decant's extraction process
Prompt 4
Show me how to run decant against the Maps icon and open the result in Icon Composer

Frequently asked questions

What is decant?

A command-line tool that extracts Apple's compiled Liquid Glass app icons from iOS and macOS 26 into editable files you can open in Icon Composer.

What language is decant written in?

Mainly Python. The stack also includes Python, Objective-C, Xcode.

How hard is decant to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is decant for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.