Skip to content

imshota1009/coding-bgm

Repository files navigation

🎵 Coding BGM

Ambient background music & Pomodoro timer for focused coding sessions — right inside VS Code.

Coding BGM

VS Code Extension 7 Sound Types Pomodoro Timer

✨ Features

  • 🎵 7 Ambient Sounds — Lo-Fi, Rain, Café, Forest, Ocean, White Noise, Fireplace
  • 🎛️ All sounds generated in-browser — No audio files needed, uses Web Audio API
  • ⏱️ Pomodoro Timer — 25min focus + 5min break (configurable)
  • 📊 Audio Visualizer — Real-time frequency visualization
  • 🎚️ Volume Control — Adjustable volume with slider
  • 📌 Status Bar Controls — Play/Pause, Sound name, Timer always visible
  • ⌨️ Keyboard ShortcutCtrl+Alt+M to toggle play/pause

🚀 Getting Started

Install from Source

  1. Clone this repository
    git clone https://github.com/imshota1009/coding-bgm.git
  2. Open the folder in VS Code
  3. Press F5 to launch the Extension Development Host
  4. Run Coding BGM: Open Player from the Command Palette (Ctrl+Shift+P)

Usage

Action How
Open player Command Palette → Coding BGM: Open Player
Play / Pause Ctrl+Alt+M or click BGM in status bar
Change sound Click sound name in status bar, or click in player
Start timer Click timer in status bar, or use player controls

🔊 Available Sounds

Sound Description
🎵 Lo-Fi Chill lo-fi beats with vinyl crackle
🌧️ Rain Gentle rain with occasional thunder
☕ Café Coffee shop ambiance with soft chatter
🌲 Forest Wind through trees with bird chirps
🌊 Ocean Rolling waves with sea breeze
📻 White Noise Classic white noise for deep focus
🔥 Fireplace Warm crackling fire

⚙️ Settings

Setting Default Description
codingBgm.pomodoroWork 25 Focus time in minutes
codingBgm.pomodoroBreak 5 Break time in minutes
codingBgm.defaultVolume 50 Default volume (0-100)

🛠️ Tech Stack

  • VS Code Extension API — Commands, Status Bar, Webview
  • Web Audio API — Programmatic sound generation
  • Vanilla JavaScript — No dependencies

📄 License

MIT License

About

🎵 VS Code extension for ambient background music & Pomodoro timer. Play Lo-Fi, Rain, Café, Forest, Ocean sounds — all generated with Web Audio API. No audio files needed.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors