This guide will walk you through installing and setting up TizenPortal on your Samsung TV.
Before you begin, make sure you have:
- Samsung Tizen Smart TV (2017-2022 models recommended)
- TizenBrew installed on your TV
- Network connectivity between your TV and any self-hosted services
If you don't have TizenBrew installed yet:
- Visit the TizenBrew GitHub
- Follow the installation instructions for your TV model
- Ensure TizenBrew is working before proceeding
Launch TizenBrew on your Samsung TV from the app list.
- Navigate to Settings or Modules
- Select Add Module
- Enter the module identifier:
axelnanol/tizenportal - Confirm the addition
- Return to the TizenBrew main menu
- Select TizenPortal from your module list
- The portal launcher should appear
When TizenPortal first loads, you'll see:
- An empty grid with a + card to add your first site
- Color button hints at the bottom of the screen
- Version number in the corner
- Use the D-pad to navigate to the + card
- Press Enter to open the site editor
- Fill in the details (changes auto-save):
- Name: Display name for the card (e.g., "My Audiobookshelf")
- URL: Full URL including
https://(e.g.,https://abs.myserver.com) - Bundle: Select from available options
- Icon: Click "Fetch Favicon" or enter a custom icon URL
- Press Close when you're done
Your new site card will appear in the grid!
| Button | Action |
|---|---|
| ← → ↑ ↓ | Navigate between cards and UI elements |
| Enter/OK | Select card, confirm actions |
| Button | Short Press | Long Press |
|---|---|---|
| 🔴 Red | Address bar | Reload page |
| 🟢 Green | Mouse mode | Edit card (portal) / Focus highlight (sites) |
| 🟡 Yellow | Preferences (portal) / Return to portal (sites) | Add Site (portal) / Return to portal (sites) |
| 🔵 Blue | Diagnostics | Safe mode |
- Navigate to a site card using the D-pad
- Press Enter to open the site
- The site loads with TV-optimized enhancements
- Use D-pad to navigate the site
- Press 🟡 Yellow to return to the portal
Now that you're set up:
- User Guide — Learn all the features
- Troubleshooting — Fix common issues
- FAQ — Answers to common questions
TizenBrew automatically serves the latest version when you use the standard module identifier. If you experience issues after an update:
- Open TizenBrew settings
- Remove the module:
axelnanol/tizenportal - Add the module again:
axelnanol/tizenportal - Relaunch TizenPortal
To remove TizenPortal:
- Open TizenBrew settings
- Navigate to the module list
- Remove
axelnanol/tizenportal
Your saved sites are stored in the TV's localStorage and will persist. To clear them, use the diagnostics panel before uninstalling.
Need help? Check the Troubleshooting guide or open an issue.