Skip to content

w00fpack/LiteTV

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Overview

screenshot

LiteTV is a small app that allows you to list, play, buffer and record TV on linux systems that hav a TV tuner adapter. LiteTV is lightweight on resources requiring very little dependencies and/or libraries.

This sofware is currently being developed, so is at Alpha level.

  • episode guide
  • scheduled recording
  • CI/CD

Add-on Requirements

  • A relatively new Linux kernel that supports DVB for the TV tune card that you have , is required.
  • w_scan is needed to scan and store TV channels that you tuner finds
  • Yad - GUIs
  • mpv - TV display
  • Streamsave mpv plug-in - Recording (optional)

Installation

Download source and do a command similar to the following:

cp -r src/* /

Quickstart

  1. Backup your ~/.config/mpv/channels.conf file (if you have one)
  2. Access your TV tuner hardware, and create a channels.conf file listing received TV channels. This can be accomplished using the GUI
    /usr/share/LiteTV/channels_add
  3. or manually via a command similar to the following
    w_scan -ft -c US -M > ~/.config/mpv/channels.conf
  4. If wanted, edit ~/.config/mpv/channels.conf to add/remove/modify channels and there names.
  5. Run /bin/litetv

You can change a station icon by adding, and naming icons under /usr/share/LiteTV

Playing and recording

While watching a channel, use the left and right arrows to jump in time. The spacebar will pause the video. Ctrl-Z starts recording, and Ctrl-X stops.

Warnings

The video replay buffer as well as video recording take up a lot of disk space. This is because most TV is transmitted uncompressed. Expect an hour long recording to take over 4GB of space.

Documentation

The GitHub Wiki can serve as a central hub for all of documentation, if there is a demand for this add-on, or if such is requested by the public. This has not been done at this time, since Blender has an add-on section on it's website (which might be used). Possible Quick links:

License

This add-on is CC0 licensed. When applicable, this license is superceded by Blender's licensing.

Contributing

To submit code changes, please open pull requests against the GitHub repository. Patches submitted in issues, email, or elsewhere will likely be ignored. Here's some general guidelines when submitting PRs:

  • In your pull request, please:
    • Describe the changes, why they were necessary, etc
    • Describe how the changes affect existing behaviour
    • Describe how you tested and validated your changes
    • Include any relevant screenshots/evidence demonstrating that the changes work and have been tested

About

Lightweight Linux DVR using a TV tuner device

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published