{"id":13599064,"url":"https://github.com/sudipghimire533/ytui-music","last_synced_at":"2025-04-10T12:31:14.456Z","repository":{"id":39661076,"uuid":"398802457","full_name":"sudipghimire533/ytui-music","owner":"sudipghimire533","description":"Youtube client in terminal for music ( lightweight youtube client )","archived":false,"fork":false,"pushed_at":"2025-03-03T20:21:40.000Z","size":5775,"stargazers_count":571,"open_issues_count":35,"forks_count":26,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-03T21:26:53.351Z","etag":null,"topics":["music","music-player","playlist","rust","tui","youtube","youtube-dl"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sudipghimire533.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-22T13:09:02.000Z","updated_at":"2025-03-03T20:21:44.000Z","dependencies_parsed_at":"2024-11-07T00:33:51.507Z","dependency_job_id":"6a8f5b55-8f48-4511-8e3d-c244d343dec2","html_url":"https://github.com/sudipghimire533/ytui-music","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudipghimire533%2Fytui-music","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudipghimire533%2Fytui-music/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudipghimire533%2Fytui-music/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudipghimire533%2Fytui-music/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudipghimire533","download_url":"https://codeload.github.com/sudipghimire533/ytui-music/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217126,"owners_count":21066633,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["music","music-player","playlist","rust","tui","youtube","youtube-dl"],"created_at":"2024-08-01T17:00:59.396Z","updated_at":"2025-04-10T12:31:14.438Z","avatar_url":"https://github.com/sudipghimire533.png","language":"Rust","funding_links":[],"categories":["Rust","\u003ca name=\"music\"\u003e\u003c/a\u003eSound and music","Table of Contents","CLI/TUI Apps","💻 Apps"],"sub_categories":["Other","🎼 Music and Media"],"readme":"# Ytui-music\nListen to music from youtube inside terminal with sleek tui\n\n![Ytui-music Search Result](screenshots/search.png)\n\n## [See more screenshots](#screenshots)\n\n---\n\n# Installation\nNOTE: since the dependency `libmpv` seems not to be maintained anymore,\n\nyou will probably need to build from source in any platform. See section *Build From Source* below.\n\n1) Download latest binary from [release page](https://github.com/sudipghimire533/ytui-music/releases/latest).\nIf binary is not available for your platform, head on to [build from source](#building-from-source)\n\n2) Give it executable permission and from downloaded directory, in shell:\n```\nytui_music run\n```\n3) You may need to jump to [Usage Guide](#usage)\n\n---\n\n## Dependencies\nYtui-music depends on mpv and youtube-dl. You may refer to the official websites of [mpv](https://mpv.io) and [youtube-dl](https://yt-dl.org).\n\nIf you have `choco` for windows or `brew` in mac or one of popular package manager in Linux you may run:\n\n### - Windows (In powershell or cmd)\n```\nchoco install mpv youtube-dl\n```\n\n### - Mac\n```\nbrew install mpv youtube-dl\n```\n\n### - Debian/Ubuntu Derivatives\n```\nsudo apt update -y\nsudo apt install -y youtube-dl libmpv1 libmpv-dev\n```\n**For other distributions, install youtube-dl and mpv packages in your preferred methods**\n\n---\n\n# Before running ytui-music\nBefore you start with ytui-music, make sure that the following directory exists and that you have write permission to ytui-music in order to save configuration file.\n## Windows\n`C:\\Users\\\u003cusername\u003e\\AppData\\Roaming` or env var `{FOLDERID_RoamingAppData}`\n\n## Mac\n`/Users/\u003cusername\u003e/Library/Application Support` or  `$HOME/Library/Application Support`\n\n## Linux\n`$HOME/.config/` or `/home/\u003cusername\u003e/.config` or env var `$XDG_CONFIG_HOME`\n\n---\n\n# Building from Source\nYtui-music is written entirely in Rust and building it from source is dead simple. All you have to do is download source, install rust and build with cargo.\n\n1) Installing rust. Head to [Rust installation](https://www.rust-lang.org/tools/install). It is basically doing\n```\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n```\n2) Get the source code. You can [download from the archives]() or use git clone:\n```\ngit clone git@github.com:sudipghimire533/ytui-music\n```\n\n3) `cd` into source root and do:\n```\ngit submodule init\nMPV_BUILD=mpv-build/ cargo build --all --release --features build_libmpv\n```\n\n4) The compiled binary is located in `target/release/` directory. Copy the `ytui_music` binary and place it somewhere where it is easy to run. Preferrably under `$PATH`.\n\n5) Ytui-music is now ready to fire. [Head over to usage](#usage)\n\n---\n\n# Usage\n\nytui-music is single binary so it shouldn't be difficult to run. Just make sure you have [installed the required dependencies](#dependencies).\n\n### Run ytui-music\n```\nytui_music run\n```\n### Show help message\n```\nytui_music help\n```\n### Show current configured shortcuts\n```\nytui_music info shortcuts\n```\n### Show version information\n```\nytui_music infor version\n```\n\n## Searching\n1) Press `/` to go to search box\n2) Type\n    - `music:Bartika Eam Rai` to search only for music result for query \"Bartika Eam Rai\"\n    - `playlist:Soft pop hits` to search only for playlist for query \"Soft pop hits\"\n    - `artist:Bibash Jk` to search only for artist for query \"Bibash Jk\"\n    - `Coding music` to search all of playlist, music and artist at once for query \"Coding music\"\n3) Press `Enter` key\n\n## Navigating\n- Use `Left arrow` or `Backspace` for backward and `Right arrow` or `Tab` key for forward to **move between Sidebar, Musicbar, Playlistbar and Artistbar**\n- Use `Up arrow` or `Down arrow` to move up or down in the list which will **highlight the list item**\n- Press `Enter` key to **select an item**\n\n## Playback control\n- Press `Space` key **to pause/unpause the playback**\n- Press `s` key to **toggle suffle/unsuffle**\n- Press `r` key to **repeat single or all item in playlist**\n- Press `\u003e` for forward and `\u003c` for backward **playback seek**\n- Press `CTRL+n` for next and `CTRL+p` to **change track**\n\n## Downloading\n1) Highlight the item you want to download. Currently downloading of music and playlist is supported.\n2) Press `CTRL+d` to **download the selection**\n\n## Quitting\n- Press `CTRL+c` to **quit ytui-music**\n- If download is ongoing, press `CTRL+ALT+C` to force quit\n\n## Adding to favorites\n1) Highlight the item you want to add or remove from favorites\n2) Press `f` to add or `u` to remove from favorites\n3) To see your list\n    - Favorite music are shown in `Liked` section in sidebar\n    - Favorite playlists are shown in `My playlist` section in sidebar\n    - Favorite artists are shown in `Following` section in sidebar\n\n---\n\n# Screenshots\nThis is what ytui-music looks like. It may even look better on yours. ;)\n\u003cdetails\u003e\n\n\u003csummary\u003e Click to see screenshots\u003c/sumary\u003e\n\n![Initial Screen](screenshots/initial-screen.png)\n![Searching Music](screenshots/music-search.png)\n![Search Results](screenshots/search.png)\n![Responsive UI](screenshots/small-screen.png)\n![Music Info](screenshots/music-info.png)\n![Playing Music](screenshots/playing.png)\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudipghimire533%2Fytui-music","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudipghimire533%2Fytui-music","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudipghimire533%2Fytui-music/lists"}