Skip to content

A script for the KDE widget "Fokus" to listen to youtube videos

License

Notifications You must be signed in to change notification settings

Gemmstone/LoFi-Fokus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LoFi-Fokus

A Bash script for the KDE widget, Fokus, to listen to youtube Lo-Fi while working. it does this by playing a YouTube video. It uses the yt-dlp program to download the video's audio and play it in mplayer.

Why?

As someone with ADHD, I struggle with focus during work sessions. I discovered "Fokus", a pomodoro timer widget, which has been a helpful tool to manage my work sessions and breaks. However, I still find it difficult to concentrate, i know that music helps me too so i decided to combine both.

To help with this, I decided to make this script to be able to play random LoFi videos during my breaks when in "focus" mode. I find that background noise, such as music or white noise, can help me concentrate and filter out distractions. LoFi videos, in particular, are known for their relaxing and calming background music, which creates a peaceful and focused environment.

This helps me to relax while I work, and ultimately supports my productivity and mental health. By integrating this script with the Fokus widget, I have created a streamlined and effective workflow that (I hope) works for me.

DISCLAIMER: While my script, LoFi videos and pomodoro timers may be helpful tools for some individuals with ADHD, it is important to note that ADHD is a complex disorder and requires a multifaceted treatment approach. None of these should be considered a substitute for medical advice or therapy.

Installation

Install Dependencies

Debian/Ubuntu
sudo apt-get install yt-dlp notify-send mplayer
Arch Linux
sudo pacman -S yt-dlp notify-send mplayer

Clone the repository

git clone https://github.com/Gemmstone/LoFi-Fokus.git

Configuration

  • Edit the contents of duration.txt file to the focus time you prefer (25min by default), remember to also set up the same focus time in Fokus

  • OPTIONAL: Add the YouTube urls you want into urls.txt, they have to be the same or longer than the time you've chosen before, there's a couple of urls by default, one of the urls will be chosen at random every run.

Add permisions

sudo chmod +x run.sh
sudo chmod +x stop.sh

Setup

  • Add the file run.sh to Fokus in

    • Start focus
    • End Break
  • Add the file stop.sh to Fokus in

    • Start Break
    • End focus
    • Stop

Usage

  • Just start your pomodoro timer with Fokus and it should start playing!

    • It might take some time to run the first time while it downloads the mp3 files!
  • It'll stop once the time is over and your break has started.

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue on the GitHub repository. If you want to contribute code, please fork the repository, create a branch for your changes, and submit a pull request.

License

The LoFi-Fokus Script is released under the GNU General Public License v3.0. See the LICENSE file for details.

About

A script for the KDE widget "Fokus" to listen to youtube videos

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages