Show HN: Musicli – 터미널의 간단한 lofi 음악 플레이어

Open your terminal. Set the mood. Stay in flow. musicli is a keyboard-first music player for local folders and stream URLs, with scene visuals, long-form ambience loops, and in-terminal search. Why Musicli · Quick Start · Use It · Controls · Presets · Library · Development - Full-screen terminal playback built for long focus sessions, not playlist management overhead. - Live ambience mixing with six long-session layers: rain ,cafe ,fire ,thunder ,forest , andcity . Track volume starts at0.25 on first run and remembers the last level you used.- Search that stays in the terminal and does not interrupt playback. - Scene-driven visuals with a portable renderer by default and a sharper chafa path when available. - One source manager for local folders, saved streams, and recent one-offs. - Local-folder-first onboarding with a native folder picker on supported systems. - A catalog-first music library with installable packs, ready for a standalone library repo or release assets. musicli is not trying to be a generic music app in a terminal. The point is atmosphere with very little friction. Node.js 22+ ffmpeg required for playbackchafa optional, recommended for better scene detailyt-dlp optional, only needed for YouTube URLs passed to--url - Native folder picker support: - macOS: built-in through osascript - Linux: zenity orkdialog recommended - macOS: built-in through Example dependency install: brew install ffmpeg chafa yt-dlp # or sudo apt install ffmpeg chafa zenity git clone https://github.com/btahir/musicli.git cd musicli npm install npm run dev npm run build node dist/index.js npm install -g @bilalpm/musicli musicli If you installed Musicli with npm, you can update it in place later with: musicli update musicli musicli --folder ~/Music/Lofi musicli --url https://www.youtube.com/watch?v=jfKfPfyJRdk On first run, musicli opens an idle welcome screen. After you choose a local folder or stream, Musicli remembers the last source and starts there automatically next time. Use --home anytime to reopen the welcome screen on launch. musicli musicli --preset chill musicli --preset jazz musicli --preset snow musicli --home On first launch, running musicli with no source starts idle and opens a welcome screen. After that, Musicli resumes the last source you used unless you pass --home . Local Folder is the default path.- On macOS, Musicli opens the system folder picker so you can choose music without typing the path. - On Linux, it uses zenity orkdialog when available. - If no native picker is available, Musicli falls back to the in-terminal path editor. - If you already know the source, --folder and--url skip onboarding and go straight in. musicli --rain 0.40 --city 0.20 musicli --forest 0.50 musicli --fire 0.25 --cafe 0.20 musicli --scene alley musicli --scene-renderer chafa The Track row starts at 0.25 on first run. After that, Musicli remembers the last Track level you used in ~/.musicli/settings.json . On local tracks, [ and ] seek backward or forward by 10s . Streams stay live and do not expose seeking. musicli --url http://myserver:8000/lofi-stream musicli --url https://example.com/stream.m3u8 musicli --url https://www.youtube.com/watch?v=jfKfPfyJRdk Stream support is best-effort and meant for user-provided URLs. - If possible, prefer local folders or openly licensed packs. - YouTube support is optional and depends on third-party tooling such as yt-dlp . - Musicli is not affiliated with YouTube. - Accessing YouTube through third-party tools may violate YouTube's Terms of Service. If you use YouTube URLs, you are responsible for complying with YouTube's terms and any applicable law. Inside the app, press o to open Sources . a adds a local folder and opens the native folder picker when availableu opens the stream URL editore edits the selected saved sourced deletes it The source editor still supports manual paths and URLs, but the local-folder flow now starts with browse-first behavior instead of making you remember the path. It gives you: - one place to manage both local folders and stream URLs - real cursor editing for the URL or path when you need it - saved reusable stream sources alongside recent one-offs Use o anytime to reopen your sources. musicli --folder ~/Music/Lofi musicli --folder "/Volumes/Archive/Focus Mixes" Inside the app, press o , then a . On supported systems that opens a native folder picker; otherwise Musicli falls back to a manual path editor. Open Lo-fi is a separate open music pack for Musicli, with 150+ lo-fi songs you can download and listen to locally. If you want a ready-made library instead of pointing Musicli at your own folder, this is the easiest local-first option. The simplest flow today is: - Download openlofi.zip from the latest release. - Extract it anywhere on your machine. - Point Musicli at the extracted folder. Example: curl -L https://github.com/btahir/open-lofi/releases/latest/download/openlofi.zip -o openlofi.zip unzip openlofi.zip -d ~/Music/open-lofi musicli --folder ~/