Viewfinder

Quick rating

Viewfinder

No reviews yet

A shader debugging mod for Iris on Fabric that exposes an HTTP API and in-game commands for external tools and scripts to inspect, test, and automate shader development workflows.

Mod Loaders
Fabric
Minecraft
26.1
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Required
Server Unsupported

About

Project Details

Type
Mod
License
MIT License
Latest Version
1.0.0
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

Viewfinder

A shader debugging mod for Iris on Fabric that exposes an HTTP API and in-game commands for external tools and scripts to inspect, test, and automate shader development workflows.

Features

  • Shader reload and error list - trigger shader reloads and capture compilation errors
  • GPU timing metrics - collect per-pass GPU timing data (collects multiple frames to average out noise)
  • Texture dumping - export textures as PNG or raw binary by name (colortex0, or custom texture)
  • SSBO buffer dumping - dump shader storage buffer objects to disk for analysis
  • Screenshot scheduling - schedule screenshots with configurable frame delay (for PT)
  • Patched shader listing - find which patched shader errored programmatically by listing all and searching for "errored"

Installation

  1. Install Fabric Loader (≥ 0.18.4) for Minecraft 26.1
  2. Install Fabric API and Iris (which requires Sodium)
  3. Drop the Viewfinder .jar into your mods/ folder

Usage

In-game commands

All commands are registered under /viewfinder:

Command Description
/viewfinder status Show current shaderpack name, error count, and API address
/viewfinder reload Reload shaders and report any compilation errors
/viewfinder errors List all captured shader errors
/viewfinder screenshot [frames] Take a screenshot (optionally delayed by N frames)
/viewfinder screenshot result Show the path of the last screenshot
/viewfinder metrics Display per-pass GPU timings
/viewfinder ssbo list List active SSBO buffers
/viewfinder ssbo dump <index> Dump an SSBO buffer to ssbo_dumps/
/viewfinder texture list List available colortex and custom textures
/viewfinder texture dump name <name> [raw] Dump a texture by name (PNG or raw)
/viewfinder texture dump id <id> [raw] Dump a texture by GL id (PNG or raw)
/viewfinder patched_shaders List Iris patched shader files

HTTP API

Viewfinder starts an HTTP server on localhost:7150. A full OpenAPI 3.0 spec is available at GET /.

Method Endpoint Description
GET / OpenAPI 3.0 specification
GET /status Shaderpack status (loaded pack name)
POST /reload Reload shaders, returns success and errors
GET /errors List captured shader errors
POST /screenshot?frames=N Schedule a screenshot (default: next frame)
GET /screenshot/result Path to the last saved screenshot
GET /metrics GPU timing metrics
GET /list-ssbo List active SSBO buffers
POST /ssbo?index=N Dump SSBO at given index
GET /list-textures List available textures
POST /texture?name=...&raw=bool Dump texture by name
POST /texture?id=...&raw=bool Dump texture by GL id
GET /patched_shaders List patched shader files

All responses are JSON. Dumped files (textures, SSBOs, screenshots) are written to subdirectories inside the Minecraft game directory.

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works