Skip to content

BISHT-CX/focus-symphony-

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Focus-Symphony 🎻

Focus-Symphony is an open-source productivity suite designed for developers who want to achieve deep work without digital noise. It combines a powerful Go-based terminal orchestrator with a sleek, responsive landing page.


| __ )_ / || | | | | | _ | |_ | || | | |
| |
) | | ) | _ | | |
|
/|/|| || |_|


🚀 Key Instruments (Features)

🎼 The Orchestrator (CLI)

A high-performance Go engine that balances your session:

  • Acoustic Shield: Automatically blocks distracting websites (YouTube, Reddit, Twitter) by managing /etc/hosts.
  • Terminal Music Player: Stream focus-optimized playlists directly from your terminal.
  • System Telemetry: Real-time monitoring of your focus session and system performance.

🎨 Visual Rhythm (Web)

A modern landing page designed with Vanilla CSS and ScrollReveal:

  • Terminal Simulator: Interactive demonstration of CLI commands.
  • Responsive Design: Optimized for all devices, ensuring your focus stats are always visible.
  • Modern Aesthetics: Clean typography and interactive animations.

🛠️ Installation

One-Command Install (Recommended)

git clone https://github.com/BISHT-CX/focus-symphony-.git
cd focus-symphony-
chmod +x build.sh && ./build.sh

The installer auto-detects your system and installs missing dependencies via pacman, apt, dnf, brew, zypper, or apk.


⚠️ Important: Site Blocking & DNS

If site blocking (YouTube, etc.) does not seem to work even after running start:

  1. Disable "Secure DNS" / "DNS over HTTPS" in your browser settings (Chrome: Settings -> Security -> Use secure DNS; Firefox: Settings -> Privacy & Security -> DNS over HTTPS).
  2. Restart your browser after running start for the changes to take effect.
  3. Flush your DNS cache (Linux: resolvectl flush-caches or sudo systemd-resolve --flush-caches).

Manual Install

go build -o focus-symphony main.go
mv focus-symphony ~/.local/bin/

# Install Assets (for local music playback)
mkdir -p ~/.local/share/focus-symphony/assets
cp assets/lofi.mp3 ~/.local/share/focus-symphony/assets/

Dependencies

Tool Purpose
go Build the binary
mpv Audio playback engine
yt-dlp Stream resolver for online tracks

Note: yt-dlp is best installed via pip3 install yt-dlp to stay up to date.

A note on sudo

start and stop modify /etc/hosts and require root. If you run focus-symphony as a normal user and type start, the app will automatically prompt for your password and re-launch with sudo — you don't need to close and reopen it.


🎮 How to Conduct Your Session

Available commands in the Orchestrator:

  • start - Activates the Acoustic Shield and begins your focus session.
  • music - Launches the terminal music player with focus playlists.
  • stop - Deactivates site blocking and restores system defaults.
  • help - Displays available session controls.
  • exit - Gracefully closes the Orchestrator.

🛠️ Technical Stack

  • Backend: Go (Orchestrator Engine)
  • Frontend: HTML5, Vanilla CSS, JavaScript (Visual Rhythm)
  • Animations: ScrollReveal.js
  • Icons: Remix Icon

🤝 Collaboration

This project is an Open Source initiative by BISHT in collaboration with Flavourtown.


Built with passion for the developer community. Harmonizing Linux Performance for Deep Work.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors