{"id":13610726,"url":"https://github.com/sdushantha/kunst","last_synced_at":"2025-04-05T23:12:02.195Z","repository":{"id":45140856,"uuid":"170372402","full_name":"sdushantha/kunst","owner":"sdushantha","description":"Download and display album art or display embedded album art","archived":false,"fork":false,"pushed_at":"2024-01-06T08:24:11.000Z","size":36333,"stargazers_count":315,"open_issues_count":14,"forks_count":28,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-29T22:09:05.185Z","etag":null,"topics":["album-art","album-cover","bash","commandline","linux","mpc","mpd","music","suckless"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdushantha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-02-12T18:50:25.000Z","updated_at":"2025-03-29T19:26:54.000Z","dependencies_parsed_at":"2024-01-06T09:26:22.550Z","dependency_job_id":"9dc7036f-750f-45cf-94e0-b5ac8ba56ac9","html_url":"https://github.com/sdushantha/kunst","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fkunst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fkunst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fkunst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Fkunst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdushantha","download_url":"https://codeload.github.com/sdushantha/kunst/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411239,"owners_count":20934653,"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":["album-art","album-cover","bash","commandline","linux","mpc","mpd","music","suckless"],"created_at":"2024-08-01T19:01:47.421Z","updated_at":"2025-04-05T23:12:02.175Z","avatar_url":"https://github.com/sdushantha.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"extra/kunst_logo.png\"\u003e\u003cbr\u003e\u003csub\u003e✨ Download and display album art or display embedded album art  ✨\u003c/sub\u003e\u003c/p\u003e\n\n```kunst``` is a daemon that extracts the album art from the songs playing in ```mpd``` and displays them in the a little window. It doesn't loop on a timer, instead it waits for ```mpd``` to send a ```player``` event. When it receives a ```player``` event, it wakes up and extracts the album art of the current playing track. This makes ```kunst```really lightweight and makes it idle at ```~0%``` CPU usage. If there no embbeded album art, it will try to fetch the album art from the internet.\n\n\n\u003cp align=\"left\"\u003e\n\u003cimg src=\"extra/demo.gif\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n## Dependencies\n- ```sxiv```\n- ```bash```\n- ```ffmpeg```\n- ```mpc```\n- ```jq```\n- ```mpd```\n\n\n## Installation\n### Install using ```make```\n```bash\n# Clone the repo\n$ git clone https://github.com/sdushantha/kunst\n\n# Change your current directory to kunst\n$ cd kunst\n\n# Install it\n$ sudo make install\n```\n### Install it locally\n\n```bash\n# Download the kunst source code, save as kunst, make it executeable\n# and then move it to ~/.local/bin\n$ curl -L git.io/raw-kunst \u003e kunst \u0026\u0026 chmod +x kunst \u0026\u0026 mv kunst ~/.local/bin\n```\n\n## Usage\n\n```bash\n$ kunst --help\nusage: kunst [-h] [--size px] [--music_dir path/to/dir] [--silent] [--version]\n\n┬┌─┬ ┬┌┐┌┌─┐┌┬┐\n├┴┐│ ││││└─┐ │\n┴ ┴└─┘┘└┘└─┘ ┴\nDownload and display album art or display embedded album art\n\noptional arguments:\n   -h, --help            show this help message and exit\n   --size                what size to display the album art in\n   --position            the position where the album art should be displayed\n   --music_dir           the music directory which MPD plays from\n   --silent              dont show the output\n   --version             show the version of kunst you are using\n```\n\n\n## Configure\nYou can configure `kunst` through environment variables.\n\n```bash\n# The size of the album art to be displayed\nexport KUNST_SIZE=\"250x250\"\n\n# The position where the album art should be displayed\nexport KUNST_POSITION=\"+0+0\"\n\n# Where your music is located\nexport KUNST_MUSIC_DIR=\"/home/username/Music/\"\n```\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://www.reddit.com/user/SpicyBroseph\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/27065646/53107999-89ec9480-3536-11e9-98a2-9ff416bf4589.png\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\n## License\nMIT License\n\nCopyright © 2019 Siddharth Dushantha\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Fkunst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdushantha%2Fkunst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Fkunst/lists"}