JellyTizen

One-click Jellyfin installation for Samsung Tizen TVs and projectors.

A modern GTK4 application that simplifies installing the Jellyfin media server client on Samsung Smart TVs running Tizen OS.

✨ Features

• 🔍 Automatic TV Discovery - Find Samsung TVs on your network automatically
• 🐳 Docker Integration - No manual SDK setup required
• 📦 One-Click Install - Simple installation process with progress tracking
• 🖥️ Modern UI - Built with GTK4 and Libadwaita for native Linux experience
• 🌐 Multi-language - English and Portuguese support

📋 Requirements

• Linux
• Docker (installed automatically if missing)
• Samsung TV with Developer Mode enabled

🚀 Quick Start

1. Install Dependencies

# Arch/Manjaro
sudo pacman -S python-gobject gtk4 libadwaita vte4

# Debian/Ubuntu
sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adwaita-1 gir1.2-vte-3.91

# Fedora
sudo dnf install python3-gobject gtk4-devel libadwaita-devel vte291

2. Clone and Run

git clone https://github.com/talesam/jellytizen.git
cd jellytizen
python main.py

📺 Enable Developer Mode on TV

For Samsung TVs (2024+)

1. Go to Apps on your TV
2. Scroll to App Settings
3. Press 123 on your remote
4. Enter 12345 - Developer Mode menu appears
5. Toggle Developer Mode to On
6. Enter your computer's IP address
7. Restart your TV

🎯 Usage

1. Welcome - App checks if Docker is installed
2. Device Setup - Select your TV from discovered devices or enter IP manually
3. Install - Click "Install Jellyfin" and wait for completion
4. Done - Open Jellyfin from your TV's app list!

⚙️ Configuration

Settings are stored in ~/.config/jellytizen/config.json:

• Docker image preferences
• Network scanning parameters
• Logging levels

🔧 Troubleshooting

Issue	Solution
Docker not running	sudo systemctl start docker
TV not found	Ensure TV and PC are on same network
Connection failed	Enable Developer Mode on TV, restart TV
Installation hangs	Check Docker logs, ensure disk space

Logs: ~/.local/share/jellytizen/logs/

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a Pull Request

📄 License

GPL-3.0 License - See LICENSE

🙏 Acknowledgments

• Jellyfin - The Free Software Media System
• install-jellyfin-tizen - Original installation scripts
• GNOME - GTK4 and Libadwaita