development

Getting Started

Kano Video is written in Python, which makes it easy to set up and start hacking on it right away. Before you start, there are a few dependencies you need to install on your Pi:

sudo apt-get install python python-gi kano-toolset omxplayer

Then just clone the repository and you should be ready to go:

# Make a local copy of the code repository
git clone git@github.com:KanoComputing/kano-video.git

# Find the executable and run it
cd kano-video/bin
./kano-video

Code Structure

The following section is a brief where's what of Kano Video. It will give you a high-level overview of the codebase.

bin/

There are currently two executables inside the bin/ directory: kano-video and kano-video-cli. The former one is the launcher for the application, and the latter a tool for using the playing functionality through a CLI interface.

kano_video/

This contains the main body of the Python code. An attempt has been made to split the UI from the functionality and as such there are two modules - ui and logic.

ui/

• main_window.py: The main window widget. Manages the views
• view.py: The selection of body views
• header.py: The selection of bars for the top of windows
• bar.py: Reusable horizontal sections
• general.py: Universal (base) widgets
• video.py: Widgets for displaying videos
• playlist.py: Widgets for displaying playlists
• popup.py: Popup windows
• icons.py: Icon utility functions

logic/

• player.py: Functions for playing videos
• playlist.py: Structures for managing playlists
• playudev.py: Tools for handling input events while watching videos
• youtube.py: Functions for interfacing with the Youtube API

paths.py: Abstractions for handling file paths

#### media/

This directory contains CSS styles for GTK3 and graphics for the application.

kdesktop/

An icon that will be installed to the kdesk configuration dirs to put an icon to the desktop.

icon/

Icon and .app files (compiled to .desktop files - see kano-apps for more details on this file)

debian/

Contains the Debian packaging files. These are the instructions how to build the *.deb package from the sources.