tizenportal

Audiobookshelf Bundle

Version: 1.0.0
Purpose: TV-optimized interface for Audiobookshelf media server

Overview

The Audiobookshelf bundle provides comprehensive TV remote control support for Audiobookshelf, a self-hosted audiobook and podcast server. It enables full navigation and media playback control using only your Samsung TV remote.

Features

1. TV Remote Navigation

Complete D-pad navigation for all Audiobookshelf interfaces:

2. Card-Based Navigation

Optimized for Audiobookshelf’s card layouts:

All cards are automatically made focusable and navigable with proper spacing.

3. Media Key Support

Full media control integration:

4. Focus Management

Intelligent focus handling:

5. Login Page Support

Special handling for Audiobookshelf login:

6. Spatial Navigation

Uses Directional Mode (preferred) for natural TV navigation:

7. Viewport Lock

Forces 1920×1080 resolution:

Configuration

The bundle uses these settings:

{
  "navigationMode": {
    "mode": "directional",
    "required": false
  },
  "viewportLock": "force",
  "features": {
    "tabindexInjection": true,
    "scrollIntoView": true,
    "wrapTextInputs": true
  }
}

Features Enabled

Key Mappings

In addition to standard color button mappings, the bundle provides:

Key Function
Media Keys  
Play/Pause Control audiobook playback
Stop Stop playback
Rewind Skip backward
Fast Forward Skip forward
Previous/Next Navigate chapters/episodes
D-Pad  
Arrow keys Navigate cards and UI elements
Enter Activate selected item
Back Go back / close modal

Installation

  1. Open TizenPortal on your TV
  2. Press Yellow (Add Site)
  3. Enter your Audiobookshelf URL (e.g., http://192.168.1.100:13378)
  4. Select Audiobookshelf from the bundle dropdown
  5. Save the card

The bundle will be automatically loaded when you navigate to your Audiobookshelf site.

Supported Audiobookshelf Pages

The bundle handles all major Audiobookshelf interfaces:

Requirements

Core Integration

This bundle leverages TizenPortal core utilities:

Note: The bundle does NOT reimplement core functionality. It uses the provided utilities for consistency.

Troubleshooting

Cards Not Focusable

If book/series cards aren’t responding to arrow keys:

  1. Press Blue (Diagnostics) and check console for errors
  2. Verify the bundle is loaded (should show “Audiobookshelf bundle activated”)
  3. Try pressing Blue + long press for safe mode (reloads without bundles)
  4. Check if your Audiobookshelf version has different DOM structure

Focus Lost in Modals

If focus escapes from open modals:

  1. The bundle has focus trap logic - this shouldn’t happen
  2. Check diagnostics for error messages
  3. Report the specific modal that’s problematic (include page URL)

Media Keys Not Working

If play/pause doesn’t control playback:

  1. Ensure your TV remote supports media keys
  2. Check that TizenBrew has registered the media keys (package.json)
  3. Verify playback is active (keys only work when player is open)

If navigation jumps unexpectedly:

  1. Try switching to Geometric Mode in site preferences
  2. Press Yellow (Preferences) → Select your ABS card → Change Navigation Mode
  3. Geometric mode is stricter (axis-aligned only)

Files

Credits

Bundle authored by the TizenPortal team for the Audiobookshelf community.

Audiobookshelf is developed by advplyr.

Support

For bundle issues:

For Audiobookshelf issues: