Community Channel Helper

A GTK-based Python application for searching movies via the TMDB API and managing a custom list of movies with streaming links and quality information.

Features

• Search movies using TMDB API
• Display movie posters and details
• Add movies to a custom list with streaming links and quality information
• Save the movie list to a JSON file

Requirements

• Python 3.6+
• PyGObject (for GTK bindings)
• requests library

Installation

1. Install system dependencies:

   # On Ubuntu/Debian:
   sudo apt-get install python3-gi python3-gi-cairo gir1.2-gtk-3.0
   
   # On macOS with Homebrew:
   brew install pygobject3 gtk+3
   

2. Install Python dependencies:

   pip install -r requirements.txt
   

Usage

Run the application:

python community_channel_helper.py

How to Use

1. Search for a movie: Enter the movie title in the search box and click "Cerca"
2. Select a movie: Choose a movie from the search results to view details and poster
3. Add streaming link: Enter the streaming URL and quality (e.g., 1080p)
4. Add to list: Click "Aggiungi alla lista" to add the selected movie with its streaming info
5. Save list: Click "Salva Lista" to export your movie list to movies_list.json
6. API Key: Optionally enter your TMDB API key (or use the default one in the code)

Configuration

The application includes a default TMDB API key, but you can use your own by:

• Entering it in the API Key field in the UI
• Or modifying the api_key variable in the source code

Output Format

The saved movies_list.json file contains an array of movies with the following structure:

{
  "movies_list": [
    {
      "title": "Movie Title",
      "year": "2023",
      "tmdb_id": 12345,
      "links": [
        {
          "url": "streaming-url",
          "quality": "1080p"
        }
      ]
    }
  ]
}

Dependencies

• gi.repository.Gtk - GTK+ 3 GUI toolkit
• requests - HTTP library for API calls
• json - For saving/loading data
• GdkPixbuf - For image handling