​

Formatters Guide

Formatters control how streams appear in your player’s selection interface. Core Builds includes several custom formatters optimized for different viewing preferences.

​

🎨 Available Formatters

All Core Builds formatters use id: tamtaro with definitions.overrides['tamtaro'] configuration.

​

Core Nexus Elite (Default)

Key Features:

• Quality tier badges (REMUX, BRRip, WEBRip, etc.)
• Video codec icons (H.265, H.264, AV1)
• Audio format badges (Atmos, DTS-X, TrueHD)
• HDR indicators (DV, HDR10+, HDR10)
• Smart title formatting with size and bitrate
• Cached/uncached visual distinction

​

Core Nexus TV

Key Features:

• Larger text for TV viewing distances
• Simplified badge system
• High contrast colors
• Optimized for 10-foot interfaces

​

Core Syntax V3

Key Features:

• Detailed technical information
• Full codec specifications
• Bitrate and efficiency metrics
• Source tracker identification

​

📦 How Formatters Work

Formatters process stream metadata and transform it into visual elements:

{
  "id": "tamtaro",
  "overrides": {
    "title": "{quality} {resolution} {codec} | {size}",
    "badges": ["cached", "hdr", "atmos"],
    "colors": {
      "cached": "#00ff00",
      "uncached": "#ff9900"
    }
  }
}

​

🔧 Importing a Formatter

​

🎯 Formatter Components

​

Quality Badges

Formatters display quality tiers as visual badges:

​

Codec Icons

Visual indicators for video codecs:

​

Audio Badges

Premium audio format indicators:

​

HDR Indicators

Dynamic range format badges:

​

🛠️ Customizing Formatters

​

Basic Customization

You can modify formatter behavior by editing the JSON:

{
  "definitions": {
    "overrides": {
      "tamtaro": {
        "showSize": true,        // Show file size
        "showBitrate": true,     // Show bitrate
        "showTracker": false,    // Hide tracker name
        "groupByQuality": true   // Group by quality tier
      }
    }
  }
}

​

Color Schemes

Adjust colors for different stream states:

{
  "colors": {
    "cached": "#22c55e",      // Green for cached
    "uncached": "#f59e0b",    // Orange for uncached
    "downloading": "#3b82f6", // Blue for downloading
    "failed": "#ef4444"       // Red for failed
  }
}

​

Title Formatting

Control how stream titles appear:

{
  "title": {
    "template": "{quality} {resolution} | {size} | {seeders}S",
    "maxLength": 100,
    "truncate": "middle"
  }
}

​

📊 Formatter Comparison

​

🎨 Visual Examples

The Core Builds configurator includes a live preview feature that shows exactly how your formatted streams will appear in your player. The preview updates in real-time as you customize your formatter settings.

​

Elite Formatter Output

🟢 REMUX 4K [H.265] [Atmos] [DV] | 45.2 GB
🟠 BRRip 1080p [H.264] [DTS-HD] | 12.8 GB
🟢 WEB-DL 1080p [H.265] [DD+] | 4.7 GB

Visual badges show:

• 🟢 Green dot = Cached/available instantly
• 🟠 Orange dot = Uncached/needs download
• Quality tier badges with distinct colors
• Codec and audio format in brackets
• File size prominently displayed

​

TV Formatter Output

✓ 4K REMUX - 45GB
⏳ 1080p BluRay - 13GB
✓ 1080p WEB - 5GB

Simplified for TV viewing:

• ✓ Checkmark = Available
• ⏳ Hourglass = Processing needed
• Larger text for 10-foot viewing
• Minimal technical details

​

Syntax V3 Output

[CACHED] REMUX.2160p.HEVC.TrueHD.7.1.Atmos-TRACKER | 45.2GB @ 65Mbps
[UNCACHED] BluRay.1080p.x264.DTS-HD.MA.5.1-GROUP | 12.8GB @ 18Mbps

Maximum information density:

• Cache status in brackets
• Full technical specifications
• Bitrate information
• Source tracker identification

​

⚡ Performance Tips

​

🔄 Updating Formatters

Core Builds formatters are regularly updated. To get the latest version:

1. Check the Formatters folder on GitHub
2. Download the updated JSON
3. Re-import using the steps above

​

🆘 Troubleshooting