{"id":18878250,"url":"https://github.com/uriel1998/vindauga","last_synced_at":"2025-04-14T18:32:10.128Z","repository":{"id":48218433,"uuid":"194195196","full_name":"uriel1998/vindauga","owner":"uriel1998","description":"Download and display album art or display embedded (or folder-based) album art using a bash script; a largely rewritten fork of kunst","archived":false,"fork":false,"pushed_at":"2023-11-14T09:58:25.000Z","size":727,"stargazers_count":13,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-28T07:20:50.305Z","etag":null,"topics":["album-art","bash","commandline","conky","linux","mpc","mpd","music-player-daemon","suckless"],"latest_commit_sha":null,"homepage":"https://uriel1998.github.io/vindauga","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/uriel1998.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-28T02:48:21.000Z","updated_at":"2024-07-23T03:02:04.000Z","dependencies_parsed_at":"2024-11-08T06:37:10.529Z","dependency_job_id":null,"html_url":"https://github.com/uriel1998/vindauga","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fvindauga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fvindauga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fvindauga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fvindauga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uriel1998","download_url":"https://codeload.github.com/uriel1998/vindauga/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248936850,"owners_count":21186115,"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","bash","commandline","conky","linux","mpc","mpd","music-player-daemon","suckless"],"created_at":"2024-11-08T06:25:24.870Z","updated_at":"2025-04-14T18:32:09.840Z","avatar_url":"https://github.com/uriel1998.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vindauga\n\nDisplay album art or display embedded (or folder-based) album art using a bash script. Massively simplified.\n\n![vindauga logo](https://raw.githubusercontent.com/uriel1998/vindauga/master/vindauga.png \"logo\")\n\n![Output example](https://raw.githubusercontent.com/uriel1998/vindauga/master/output.gif \"Example output\")\n\n## Contents\n 1. [About](#1-about)\n 2. [License](#2-license)\n 3. [Prerequisites](#3-prerequisites)\n 4. [How to use](#4-how-to-use)\n \n***\n\n## 1. About\n\n`vindauga` is a program that finds the album art for the currently playing song \nin `audacious` or `mpd`, and then displays it in a little window or as part of \na `conky` display.\n\n`vindauga` now loops on a timer. \nit looks at the currently playing track from `audacious` first (because that's always local) \nand if that's not running, then `mpd`. It then looks in the music directory to find \neither `folder.jpg` or `cover.jpg`, and puts that in a cache directory for reading \nby conky or what have you. \n\n\nIf *that* doesn't exist, then it decodes a built in default album image to \nthe cache directory.\n\nAt that point `conky` or any other program can display the image, which is located at \n`${XDG_CACHE_HOME}/vindauga/nowplaying.album.png` (and if you already had [yadshow](https://ideatrash.net/2023/10/get-a-quick-popup-of-your-current-cover-art-from-the-music-player-daemon-mpd.html) installed to \npop up music covers, it will create a symlink between `${XDG_CACHE_HOME}/vindauga` and `${XDG_CACHE_HOME}/yadshow`.)\n\n`vindauga` means \"window\".\n\nAll the album-art *finding* and *synchronizing* functionality has been moved and is \nfound with `f_fixer_covers`, as outlined in [this blog post](https://ideatrash.net/2023/10/finding-fixing-and-synchronizing-all-your-mp3-music-album-art-mostly-automatically-bash-script.html). \n\n\n## 2. License\n\nThis project is licensed under the MIT license. For the full license, see `LICENSE`.\n\n## 3. Prerequisites\n\n * `imagemagick` command-line tool for parsing string data. `imagemagick` can be found on major Linux distributions.\n * `mpc` command-line tool for controlling mpd. `mpc` can be found on major Linux distributions.\n * `audtool` command-line tool for audacity. \n\n## 4. How to use\n\nRun `vindauga.sh` from the command line (or crontab, or even conky itself) at an \ninterval. The current album art is output at `${XDG_CACHE_HOME}/vindauga/nowplaying.album.png` \nand the current song information is in a text file at `${XDG_CACHE_HOME}/vindauga/songinfo`.  \n\nThere is an example `conkyrc` included. Throughout, replace `/home/USER` with your \nhome directory. \n\n* `${execi 3 /path/to/vindauga.sh}` -- conky executes the program every 3 seconds, no need for cron.  \n* `${exec head /home/USER/.cache/vindauga/songinfo | sed 's/ - /\\n/g'}` -- this parses it into three lines\n* `${if_match \"${audacious_status}\" == \"Playing\"}${audacious_bar 7,253}${endif}${if_mpd_playing}${mpd_bar 7,253}${endif}` -- status bar depending on whether audacious is running or not.\n\n\n### MPD Hosts\n    \nIt assumes your music directory is in `${HOME}/Music`, that your album art is \nnamed either `cover.jpg` or `folder.jpg` and that `mpc` is already \nset up correctly. \n\nIt will attempt to use the environment variable `MPD_HOST`, and \nif it is not found, will examine `${HOME}/.bashrc` to see if it is set there (if a \nnon-login shell) and set it for the program. If you have a password set for MPD, \nyou *must* use `MPD_HOST=Password@host` for it to work.\n\nIt will put the current cover in `${XDG_CACHE_HOME}/vindauga/nowplaying.album.png` \nafter making the corners of the cover rounded. If you are also using [yadshow](https://ideatrash.net/2023/10/get-a-quick-popup-of-your-current-cover-art-from-the-music-player-daemon-mpd.html),\nit will symlink it so the two directories point to the same location to avoid duplicated effort.\n\n### With Conky\n\nI have enclosed a basic configuration for `conky` (as seen in the video above) \nthat has the information and layout that I want. Editing `conky` \nconfigurations is well past the scope of this document.\n\nSee the file `vindauga_conkyrc` for the example. \n\n![Output example](https://raw.githubusercontent.com/uriel1998/vindauga/master/updated_vindauga_conky.png \"Example output\")\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furiel1998%2Fvindauga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furiel1998%2Fvindauga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furiel1998%2Fvindauga/lists"}