# superfile | Yorukot | Knowledge Base | Instagit

Pretty fancy and modern terminal file manager

GitHub Stars: 19.9k

Repository: https://github.com/yorukot/superfile

---

## Articles

### [How Superfile's Prompt Command Line Mode Executes Shell Commands](/yorukot/superfile/how-does-superfiles-prompt-mode-execute-shell-commands)

Discover how Superfile's prompt mode executes shell commands via Go's exec package. Learn about platform-specific handling, working directory respect, and timeouts for efficient file management.

- Tags: internals
- Published: 2026-07-30

### [How Superfile Implements Compression and Extraction Functionality](/yorukot/superfile/how-does-superfile-implement-compression-and-extraction)

Explore how Superfile implements compression and extraction. Discover insights into its functionality despite potential access restrictions in the yorukot/superfile repository.

- Tags: deep-dive
- Published: 2026-07-30

### [How to Debug Superfile Issues Using Debug Mode Configuration](/yorukot/superfile/how-to-debug-superfile-issues-using-debug-mode)

Easily debug Superfile issues by enabling debug mode. Learn to use the configuration file or CLI flag for system diagnostics and dependency info. Resolve problems faster.

- Tags: how-to-guide
- Published: 2026-07-30

### [How to Add Custom File Open Commands by Extension Using `open_with` in Superfile](/yorukot/superfile/how-to-add-custom-file-open-commands-using-open_with)

Learn to add custom file open commands by extension using open_with in Superfile. Map extensions in superfile.toml and open files with your preferred program instantly.

- Tags: how-to-guide
- Published: 2026-07-30

### [How the Superfile Sidebar Displays Pinned Directories and Disk Information](/yorukot/superfile/how-does-sidebar-display-pinned-directories-and-disk-information)

Discover how the Superfile sidebar shows pinned directories and disk info by merging JSON PinnedManager data with OS mounted partitions into a unified view.

- Tags: internals
- Published: 2026-07-30

### [How Superfile Handles File Operations (Copy, Cut, Paste, Delete) Under the Hood](/yorukot/superfile/how-does-superfile-handle-file-operations-under-the-hood)

Discover how Superfile manages file operations like copy, cut, paste, and delete. Explore its model-centric workflow combining UI commands, clipboard abstraction, and file-system utilities.

- Tags: internals
- Published: 2026-07-30

### [How to Configure File Preview with Syntax Highlighting in Superfile: Chroma vs bat](/yorukot/superfile/how-to-configure-file-preview-with-syntax-highlighting)

Configure Superfile file previews with syntax highlighting. Choose between built-in Chroma or external bat for enhanced code readability. Learn how to set your preference in config.toml.

- Tags: how-to-guide
- Published: 2026-07-30

### [How Superfile's Rendering Engine Draws the TUI Interface: A Deep Dive into the Source Code](/yorukot/superfile/how-does-superfiles-rendering-engine-draw-tui-interface)

Explore Superfile's rendering engine source code to understand how it draws TUI interfaces by layering content, borders, and styling into ANSI-aware strings.

- Tags: deep-dive
- Published: 2026-07-30

### [How to Report a Bug in Superfile: Complete Guide for GitHub Issues](/yorukot/superfile/how-to-report-a-bug-in-superfile)

Report Superfile bugs effectively on GitHub. Learn how to check for duplicates and submit debug logs with spf --debug or spf --debug-info to ensure faster resolution.

- Tags: how-to-guide
- Published: 2026-07-29

### [Development Tools Used with Superfile: Complete Technical Stack Guide](/yorukot/superfile/what-development-tools-are-used-with-superfile)

Explore the technical stack behind Superfile. Discover development tools including Go, Make, Bash, Astro, pnpm, Python, and GitHub Actions for building, documenting, and testing.

- Tags: best-practices
- Published: 2026-07-29

### [How to Run Tests for Superfile: Unit Tests and Full Integration Suite](/yorukot/superfile/how-to-run-tests-for-superfile)

Learn to run Go unit tests for Superfile using make test and execute the Python integration testsuite with make testsuite. Fast and easy testing for the yorukot/superfile repo.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Is the Purpose of the Tests Directory in Superfile?](/yorukot/superfile/what-is-the-purpose-of-the-tests-directory-in-superfile)

Discover the purpose of the tests directory in Superfile. It ensures quality by housing Go unit tests and a testsuite to prevent regressions and verify cross-platform compatibility.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Troubleshoot Superfile Installation Issues: A Complete Guide](/yorukot/superfile/how-to-troubleshoot-superfile-installation-issues)

Troubleshoot Superfile installation issues by verifying OS compatibility, overriding environment variables, or building from source. Resolve architecture mismatches, network restrictions, and permission errors with this guide.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Are the Licensing Terms for Superfile? A Complete Guide to the MIT License](/yorukot/superfile/what-are-the-licensing-terms-for-superfile)

Understand Superfile's licensing terms with our MIT License guide. Discover compliant commercial use, modification, and distribution for your projects.

- Tags: getting-started
- Published: 2026-07-29

### [How to Update Superfile to the Latest Version](/yorukot/superfile/how-to-update-superfile-to-the-latest-version)

Quickly update Superfile to the latest version using its auto-update checker, installation scripts, package managers, or direct GitHub releases. Stay current with ease.

- Tags: how-to-guide
- Published: 2026-07-29

### [Performance Characteristics of Superfile: Caching, Concurrency, and Async Architecture](/yorukot/superfile/what-are-the-performance-characteristics-of-superfile)

Discover Superfile's performance: explore its O(1) caching, concurrency, and async architecture for low-latency terminal file management without UI blocking.

- Tags: performance
- Published: 2026-07-29

### [How to Use Superfile for File Organization: A Complete Guide to Terminal File Management](/yorukot/superfile/how-to-use-superfile-for-file-organization)

Master terminal file management with Superfile. This guide explains how to use Superfile for efficient organization via its dual-pane interface and vim-style shortcuts for copy, move, rename, and delete operations.

- Tags: how-to-guide
- Published: 2026-07-29

### [Are Pre-Compiled Binaries Available for Superfile? Complete Download Guide](/yorukot/superfile/are-there-pre-compiled-binaries-available-for-superfile)

Yes, find pre-compiled binaries for Superfile on macOS, Linux, and Windows via GitHub Releases, install scripts, and package managers. Download Superfile easily today.

- Tags: how-to-guide
- Published: 2026-07-29

### [Superfile Build Process and Binary Distribution Method: Complete Guide](/yorukot/superfile/what-is-the-build-process-and-binary-distribution-method-for-superfile)

Learn the Superfile build process and binary distribution for Go. Discover automated releases via shell scripts and distribution on GitHub Releases, Homebrew, Scoop, and Winget.

- Tags: how-to-guide
- Published: 2026-07-28

### [Platform-Specific Implementations for Unix vs Windows in Superfile: Build Tags Explained](/yorukot/superfile/what-are-the-platform-specific-implementations-for-unix-vs-windows-in-superfile)

Explore Unix vs Windows platform-specific implementations in Superfile using Go build tags. Learn how Superfile handles OS differences for core features while maintaining consistent APIs.

- Tags: internals
- Published: 2026-07-28

### [How Superfile Implements Code Syntax Highlighting with Chroma](/yorukot/superfile/how-does-code-syntax-highlighting-work-in-superfile-using-chroma)

Discover how Superfile achieves code syntax highlighting using the Chroma lexer library and ansichroma wrapper for vibrant terminal output. Learn the implementation details.

- Tags: internals
- Published: 2026-07-28

### [How Superfile Handles Transparency and Background Styling: A CSS Architecture Deep Dive](/yorukot/superfile/what-is-the-transparency-and-background-handling-approach-in-superfile)

Explore Superfile's CSS architecture for transparency and background styling. Discover how custom properties, gradients, and OKLCH create cohesive, theme-aware designs.

- Tags: deep-dive
- Published: 2026-07-28

### [How Superfile Handles Window Resize Events: Inside the Bubble Tea Architecture](/yorukot/superfile/how-does-superfile-handle-window-resize-events)

Discover how Superfile manages window resize events using Bubble Tea's tea.WindowSizeMsg. Learn how it updates dimensions and recalculates UI layouts efficiently.

- Tags: internals
- Published: 2026-07-28

### [How superfile Implements File Operations (Copy, Paste, Cut, Delete): A Deep Dive into the Go Source Code](/yorukot/superfile/how-are-file-operations-implemented-in-superfile)

Explore how superfile handles file operations like copy, paste, cut, and delete. Dive into the Go source code to understand its model-centric workflow, clipboard management, and TUI integration.

- Tags: deep-dive
- Published: 2026-07-28

### [Panel Layout and Rendering System Architecture in Superfile](/yorukot/superfile/what-is-the-panel-layout-and-rendering-system-architecture-in-superfile)

Explore Superfile's panel layout and rendering system architecture. Understand how independent panels are managed and rendered by custom logic utilizing the lipgloss library.

- Tags: architecture
- Published: 2026-07-28

### [How Debug Mode and Logging Work in Superfile: A Complete Technical Guide](/yorukot/superfile/how-does-debug-mode-and-the-logging-system-work-in-superfile)

Understand how debug mode and logging work in Superfile. Learn how the boolean debug flag controls the slog logger for detailed diagnostics and clean operation.

- Tags: deep-dive
- Published: 2026-07-28

### [Auto-Update Check Mechanism and Version Comparison in Superfile: How It Works](/yorukot/superfile/what-is-the-auto-update-check-mechanism-and-version-comparison-in-superfile)

Discover Superfile's auto-update check mechanism. Learn how it compares versions against GitHub releases using semantic logic when enabled.

- Tags: internals
- Published: 2026-07-28

### [How Superfile Embeds Default Configurations in Its Binary Using Go's embed Package](/yorukot/superfile/how-are-default-configurations-embedded-in-the-superfile-binary)

Learn how Superfile embeds default configurations in its binary using Go's embed package. Discover how to access themes, icons, and config files directly from the executable at startup.

- Tags: internals
- Published: 2026-07-28

### [Superfile Configuration File Loading and Validation Process](/yorukot/superfile/what-is-the-superfile-configuration-file-loading-and-validation-process)

Discover the Superfile configuration file loading and validation process. Learn how defaults merge with your TOML, fields auto-fix, and ranges validate for seamless application startup.

- Tags: internals
- Published: 2026-07-28

### [How Superfile Implements Mouse Wheel Support for File Navigation](/yorukot/superfile/how-is-mouse-wheel-support-implemented-for-file-navigation-in-superfile)

Learn how Superfile implements mouse wheel support for file navigation using Bubble Tea, intercepting tea.MouseMsg for smooth scrolling across focused panels.

- Tags: internals
- Published: 2026-07-28

### [How Fuzzy Search with fzf Integration Functions in Superfile: A Complete Guide](/yorukot/superfile/how-does-fuzzy-search-with-fzf-integration-function-in-superfile)

Discover how fuzzy search with fzf integration works in Superfile. Learn how Superfile processes directories, runs fzf searches, and displays results for efficient file navigation. A complete guide for yorukot/superfile users.

- Tags: deep-dive
- Published: 2026-07-28

### [How Selection Mode Works for Multi-File Operations in Superfile](/yorukot/superfile/how-does-selection-mode-work-for-multi-file-operations-in-superfile)

Discover Superfile's selection mode for efficient multi-file operations. Transform your file panel into a checklist for bulk copy, move, delete, and compress actions using single keystrokes.

- Tags: how-to-guide
- Published: 2026-07-28

### [Superfile Sidebar Architecture and Pinned Directories Management](/yorukot/superfile/what-is-the-sidebar-architecture-and-how-are-pinned-directories-managed-in-superfile)

Explore Superfile's sidebar architecture a hybrid system combining static TypeScript trees with dynamic JSON pinned directories for flexible documentation and custom workflows.

- Tags: architecture
- Published: 2026-07-28

### [How Superfile Handles File Compression and Extraction: A Deep Dive into the Source Code](/yorukot/superfile/how-does-superfile-handle-file-compression-and-extraction)

Explore how Superfile handles file compression and extraction using Go routines. Discover source code details for ZIP creation and multi-format extraction with hotkeys and UI progress.

- Tags: deep-dive
- Published: 2026-07-28

### [How the Trash Feature is Implemented Across Different Operating Systems in Superfile](/yorukot/superfile/how-is-the-trash-feature-implemented-across-different-operating-systems-in-superfile)

Discover how Superfile implements its trash feature across Linux macOS and Windows using native APIs and a fallback for permanent deletion. Learn about its cross-platform deletion strategy.

- Tags: internals
- Published: 2026-07-28

### [How the Superfile Hotkey System Works: Configuring Keybindings in yorukot/superfile](/yorukot/superfile/how-does-the-hotkey-system-work-and-how-are-keybindings-configured-in-superfile)

Learn how Superfile's hotkey system works via declarative TOML config files. Map actions to keys for global, typing, and mode-specific scopes, reloading dynamically without restarts.

- Tags: internals
- Published: 2026-07-28

### [How Custom Themes Are Loaded and Applied in Superfile: Complete Guide](/yorukot/superfile/how-are-custom-themes-loaded-and-applied-in-superfile)

Learn how Superfile loads and applies custom themes from TOML files. Discover the fallback mechanism for missing themes with this complete guide to yorukot/superfile customization.

- Tags: how-to-guide
- Published: 2026-07-28

### [Superfile File Preview and Image Rendering Architecture: Implementation Deep Dive](/yorukot/superfile/what-is-the-architecture-of-superfiles-file-preview-and-image-rendering)

Explore Superfile's dual-renderer architecture for file previews. It uses Kitty graphics protocol for true-color images, with ANSI 256-color fallback for unsupported terminals.

- Tags: architecture
- Published: 2026-07-28

### [How to Build superfile from Source and Run Tests](/yorukot/superfile/how-to-build-superfile-from-source-and-run-tests)

Learn to build superfile from source and run its tests. Follow simple Go build and Python script execution steps for a smooth setup.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Enable Debug Mode and Troubleshoot Issues in Superfile](/yorukot/superfile/how-to-enable-debug-mode-and-troubleshoot-issues-in-superfile)

Learn to enable debug mode and troubleshoot issues in Superfile. Use the debug flag in config.toml or the --debug-info CLI for effective problem-solving and verbose logging.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile's Clipboard Works Across Multiple Panels](/yorukot/superfile/how-does-superfiles-clipboard-work-across-multiple-panels)

Discover how Superfile's clipboard enables seamless copy-cut-paste across all file panels. Its shared clipboard model ensures operations persist regardless of panel focus an essential feature for efficient file management.

- Tags: internals
- Published: 2026-07-26

### [How to Configure open_with for Custom File Extension Handlers in Superfile](/yorukot/superfile/how-to-configure-open-with-for-custom-file-extension-handlers-in-superfile)

Configure open_with in Superfile to handle custom file extensions. Map file extensions to shell commands in config.toml using %s for the file path.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile's Search Bar Filters Files in the Current Directory](/yorukot/superfile/how-does-superfiles-search-bar-filter-files-in-the-current-directory)

Discover how Superfile filters files in the current directory using a fuzzy-search pipeline and fzf-lib to rank matching entries. Learn about this powerful feature for efficient file management.

- Tags: internals
- Published: 2026-07-26

### [How to Use the Help Menu to Discover Available Hotkeys in Superfile](/yorukot/superfile/how-to-use-the-help-menu-to-discover-available-hotkeys-in-superfile)

Discover Superfile hotkeys easily. Press ? in the TUI to open the interactive Help Menu listing all available shortcuts and their descriptions.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile Handles Trash Across Different Operating Systems](/yorukot/superfile/how-does-superfile-handle-trash-across-different-operating-systems)

Discover how Superfile manages trash on Linux, macOS, and Windows using OS-specific backends. Learn about its fallback to permanent deletion when native recycling isn't available.

- Tags: internals
- Published: 2026-07-26

### [How to Configure Default Sort Type and Order in Superfile](/yorukot/superfile/how-to-configure-default-sort-type-and-order-in-superfile)

Configure default sort type and order in Superfile easily. Edit config.toml to set sort by name size date type or natural order ascending or descending.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile’s Process Bar Displays File Operation Progress](/yorukot/superfile/how-does-superfiles-process-bar-display-file-operation-progress)

Discover how Superfile's process bar displays file operation progress in real-time. Learn about its struct, percentage calculation, and Bubble Tea integration for a clear visual experience.

- Tags: internals
- Published: 2026-07-26

### [How to Customize Border Styles and Characters in Superfile: A Complete Config Guide](/yorukot/superfile/how-to-customize-border-styles-and-characters-in-superfile)

Customize Superfile border styles and characters by editing config.toml. Learn how to tailor your terminal UI with lipgloss.Border on startup.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile Handles Compressed File Operations: ZIP Creation and Multi-Format Extraction](/yorukot/superfile/how-does-superfile-handle-compressed-file-operations-extract-compress)

Discover how Superfile efficiently creates ZIP files and extracts multiple archive formats with real-time UI progress. Learn about its robust compressed file operations.

- Tags: deep-dive
- Published: 2026-07-26

### [How to Configure cd_on_quit for Shell Integration in Superfile](/yorukot/superfile/how-to-configure-cd-on-quit-for-shell-integration-in-superfile)

Configure cd_on_quit for Superfile shell integration. Easily set this option to automatically change directories upon exiting the file manager with your chosen shell.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile's Auto-Update Check Mechanism Works](/yorukot/superfile/how-does-superfiles-auto-update-check-mechanism-work)

Discover how Superfile's auto-update check mechanism works. Learn how it queries the GitHub API on startup to ensure you have the latest version, enhancing your experience.

- Tags: internals
- Published: 2026-07-26

### [How to Use the SPF Prompt for Running Shell Commands in Superfile](/yorukot/superfile/how-to-use-the-spf-prompt-for-running-shell-commands-in-superfile)

Learn to run shell commands in Superfile using the SPF prompt. Discover how to execute native commands with ':' and built-in SPF commands with '>'

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile's Selection Mode Works for Batch File Operations](/yorukot/superfile/how-does-superfiles-selection-mode-work-for-batch-file-operations)

Learn how Superfile's selection mode achieves deterministic multi-file batch operations like copy, move, and delete using its map-based state tracker and order counter.

- Tags: internals
- Published: 2026-07-26

### [How to Customize Sidebar Sections (Home, Pinned, Disks) in Superfile](/yorukot/superfile/how-to-customize-sidebar-sections-home-pinned-disks-in-superfile)

Customize Superfile sidebar sections including home, pinned, and disks by editing the sidebar_sections array in your config.toml for a personalized file management experience.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile Displays File Metadata with ExifTool Integration](/yorukot/superfile/how-does-superfile-display-file-metadata-with-exiftool-integration)

Discover how Superfile shows file metadata. Learn about its ExifTool integration and GetMetadata function for enriched file information.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Enable and Configure Image Preview Using Sixel in Superfile](/yorukot/superfile/how-to-enable-and-configure-image-preview-using-sixel-in-superfile)

Learn to enable and configure image preview in Superfile. Superfile offers Kitty protocol or ANSI block rendering for image display.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile Renders File Previews with Syntax Highlighting Using Chroma and Bat](/yorukot/superfile/how-does-superfiles-file-preview-with-syntax-highlighting-chroma-bat-work)

Discover how Superfile renders file previews with syntax highlighting using Chroma and Bat. Learn about runtime file type detection and highlighting fallback mechanisms.

- Tags: internals
- Published: 2026-07-26

### [How to Integrate Superfile with Zoxide for Smart Directory Navigation](/yorukot/superfile/how-to-integrate-superfile-with-zoxide-for-directory-jump-navigation)

Supercharge your workflow! Integrate Superfile with zoxide for lightning-fast, fuzzy directory jumping. Enable zoxide support and navigate your file system with ease.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile Handles File Copy Operations with Progress Tracking](/yorukot/superfile/how-does-superfile-handle-file-copy-operations-with-progress-tracking)

Discover how Superfile's five-layer architecture manages file copy operations with progress tracking using processbar Process and charm land bubbles for real-time percentage updates.

- Tags: internals
- Published: 2026-07-26

### [How to Configure Custom Hotkeys and Keybindings in Superfile: The Complete TOML Guide](/yorukot/superfile/how-to-configure-custom-hotkeys-and-keybindings-in-superfile)

Learn how to configure custom hotkeys and keybindings in Superfile with this complete TOML guide. Easily personalize your workflow and boost productivity.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Superfile's Multi-Panel File Manager Architecture Works Internally](/yorukot/superfile/how-does-superfiles-multi-panel-file-manager-architecture-work-internally)

Explore Superfile's multi-panel file manager architecture. Discover its three-layer hierarchy, independent panel management, and Bubble Tea TUI framework integration for efficient navigation and rendering.

- Tags: internals
- Published: 2026-07-26