Skip to content

Misterr-H/goofyy

Repository files navigation

🎵 GOOFYY – Terminal Music Player

A sleek command-line music player that streams your favorite songs directly in the terminal! 🎸

✨ Features

  • 🎧 Stream music directly in your terminal
  • 🔍 Search and play songs instantly
  • 🎨 Clean and minimal terminal UI
  • ⚡️ Fast streaming with yt-dlp
  • 🎮 Simple keyboard controls
  • 📊 Real-time progress bar

🚀 Prerequisites

Before installing Goofyy, make sure you have:

📦 Installation

npx goofyy
# OR
npm i -g goofyy

🎮 Usage

# Start Goofyy with a song
goofyy "shape of you"

# Search and play any song
goofyy "ed sheeran perfect"

# Play with artist and song name
goofyy "bohemian rhapsody queen"

Controls

  • Press Enter to start playing
  • Press ESC to exit
  • Type to search for songs

🛠️ Technical Details

Goofyy uses:

  • yt-dlp for fetching and streaming music
  • ffmpeg for audio processing
  • React Ink for the beautiful terminal UI

🤝 Contributing

Contributions are welcome! Feel free to:

  • 🐛 Report bugs
  • 💡 Suggest new features
  • 🔧 Submit pull requests

📝 License

MIT License - feel free to use this project however you want!

🎵 Made with ❤️ by Himanshu


"Because sometimes the best music player is the one that streams directly in your terminal" 🎹

About

A music player for your terminal

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •