yatta
Yatta γ€γγΏ
[![Made with Fluent Design](https://img.shields.io/badge/fluent-design-blue?labelColor=0078D7")](https://github.com/bdlukaa/fluent_ui "Made with Fluent Design") [](https://discord.gg/QR63QRZntK "Discord") An on-demand videos client for searching, browsing, managing videos from your favorite on-demand video platforms. </br>[!WARNING]
This application is currently under development, changes on application behavior is expected without notice nor migration guide.
Features
- Search videos from your favorite platform (YouTube, Peertube, etc) π
- Video playlist (history, saved, etc) ποΈ
- Plain text database for easy scripting π
- Modal navigation for keyboard user π π― π° π±
- Middle click autoscrolling, just like web browsers π±οΈ
Supported video platforms
- YouTube (via YouTube Data API)
User guide
YouTube API key
Read the guide here. Once you obtain the API key, go to Settings > YouTube API Settings > API key and add the API key.
[!NOTE]
This API key will be good daily personal usage. For detailed breakdown on how YouTube Data API quota is calculated, read YouTube Data API (v3) - Quota Calculator. You can adjust how the app consume this quota inSettings > YouTube API Settingsby disabling/limiting few features.
Playing videos
Example below shows a guide to play video from Chromium web browser:
Go to Setting > Video play command, edit the command to:
chromium $url
You can also add extra command to run after the other command by pressing Add more button. For example you can add notification:
chromium $url
notify-send Playing video $title\n$description
Available variable to use includes:
| Name | Description | Example |
|---|---|---|
url |
- | https://www.youtube.com/watch?v=qWNQUvIk954 |
title |
- | Rick Astley - Never Gonna Stop (Official Video) |
description |
- | Never Gonna Stop (Official Video) Listen here: https://rickastley.lnk.to/NeverGonnaStopID The new album 'Are We There Yet? |
type |
Object type (possible value: video, channel, playlist) |
video |
preview |
Large size image | https://i.ytimg.com/vi/qWNQUvIk954/hqdefault.jpg |
thumbnail |
Medium size image | https://i.ytimg.com/vi/qWNQUvIk954/mqdefault.jpg |
icon |
Small size image | https://i.ytimg.com/vi/qWNQUvIk954/default.jpg |
Keyboard Navigation
| Key | Function |
|---|---|
h, j, k, l |
Move right, down, up, left |
p |
Play video |
o |
Listen video |
ctrl k / ctrl l / F2 |
Focus on search bar |
? |
#21 |
Configuring Yatta from a text editor #20
Looking for editing your Yatta configuration from a text editor? We got you covered.
Yatta uses YAML for the configuration file. Which is compatible with JSON, meaning you can use JSON if you prefer it over YAML.
Configuration file will be read based on this prority list:
$XDG_CONFIG_HOME/yatta/config.yaml
$XDG_CONFIG_HOME/yatta/config.json
$HOME/.config/yatta/config.yaml
$HOME/.config/yatta/config.json
/etc/yatta/config.yaml
/etc/yatta/config.json
A user configuration file should be created if you changed the application configuration within the application.
If you need to make a new user configuration file, simply create a new file in $XDG_CONFIG_HOME)/yatta/config.yaml*.
(Optional) Setup your language server
Install and configure yaml-languague-server for your editor.
Add this line to the top of your configuration file:
# yaml-language-server: $schema=https://gist.githubusercontent.com/brainwo/7eeddb3b5ae171ed1c86c28df1ff6c01/raw/schema.json
Documentation
Building from source
This program is written using Flutter. For installation guide, please refer to official Flutterβs setup guide. No additional build dependencies required beside the dependencies required by Flutter.
If you have a problem when building, check pubspec.lock file to find compatible Flutter SDK version to use, for example the snippet below indicating Flutter SDK version 3.19.X:
sdks:
dart: ">=3.3.0 <4.0.0"
flutter: ">=3.19.0"
Contributing
This project uses conventional commit. git-cc plugin is recommended.