{"id":13752523,"url":"https://github.com/cococry/lyssa","last_synced_at":"2025-04-09T15:50:42.963Z","repository":{"id":228956976,"uuid":"701457273","full_name":"cococry/lyssa","owner":"cococry","description":"Aestethic, minimal, suckless music player","archived":false,"fork":false,"pushed_at":"2024-05-28T13:45:39.000Z","size":20921,"stargazers_count":89,"open_issues_count":7,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-05-29T05:32:49.806Z","etag":null,"topics":["minimal","music","music-player","suckless"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cococry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-10-06T17:12:43.000Z","updated_at":"2024-05-31T08:43:31.871Z","dependencies_parsed_at":"2024-05-28T17:09:30.451Z","dependency_job_id":null,"html_url":"https://github.com/cococry/lyssa","commit_stats":null,"previous_names":["cococry/lyssa"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cococry%2Flyssa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cococry%2Flyssa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cococry%2Flyssa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cococry%2Flyssa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cococry","download_url":"https://codeload.github.com/cococry/lyssa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248063857,"owners_count":21041854,"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":["minimal","music","music-player","suckless"],"created_at":"2024-08-03T09:01:07.015Z","updated_at":"2025-04-09T15:50:42.939Z","avatar_url":"https://github.com/cococry.png","language":"C++","funding_links":[],"categories":["UI Apps/Tools","Media"],"sub_categories":["Music Player","Other"],"readme":"# Lyssa\n\n## Overview\nLyssa is a native music player designed to be an aestethic addition for every desktop. \nThe player is as easy and [suckless](https://suckless.org/philosophy) as possible to use and to work with. The application frontend \nis made to be modern and aestethic. The goal of this project is to make listening to \nmusic amazing, visually and audibly. \n\nLyssa has the capability to easily download music from \nvarious streaming services. Under the hood, yt-dlp \nis used to download the music files. \n\nThe Lyssa application is written in C++ 17. It uses the [Leif Library](https://github.com/cococry/leif), a GUI Library that i've\nwritten in C, for the entire User Interface of the Application. For windowing, the [GLFW Library](https://github.com/glfw/glfw) is used. Additionally, Lyssa depends on [taglib](https://github.com/taglib/taglib) for handling \nID3 Tags for Music Files. For Audio, Lyssa uses the [miniaudio.h library](https://github.com/mackron/miniaudio).\n\n\u003cimg src=\"https://github.com/cococry/lyssa/blob/main/branding/lyssa-showcase.png\" alt=\"Lyssa Showcase\"\u003e\n\n\n# Dependencies \n\n#### Build Dependecies\n\n| Dependency         |  Reason of Usage    |\n| ----------------|-------------|\n| [leif](https://github.com/cococry/leif) | Creating the entire UI Frontend |\n| [taglib](https://github.com/taglib/taglib)| Reading metadata of ID3 tags |\n| [miniaudio](https://github.com/mackron/miniaudio) | Audio output of the player | \n| [GLFW](https://github.com/glfw/glfw) | Handling windowing, input etc. | \n\n#### Runtime Dependencies\n\n| Dependency         |  Reason of Usage    |\n| ----------------|-------------|\n| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Downloading playlists |\n| [jq](https://github.com/jqlang/jq) | Parsing JSON of playlists |\n| [ffmpeg](https://github.com/FFmpeg/FFmpeg)| yt-dlp needs ffmpeg for extracting images |\n| [exiftool](https://exiftool.org/)| Retrieving metadata of sound files |\n\n\nAs lyssa uses the leif library which also depends on a few things there are some more leif dependecies:\n#### Leif Dependencies \n\n| Dependency         |  Reason of Usage    |\n| ----------------|-------------|\n| [glad](https://github.com/Dav1dde/glad) | Loading OpenGL functions |\n| [stb_image](https://github.com/nothings/stb/blob/master/stb_image.h) | Loading image files into memory |\n| [stb_image_resize2](https://github.com/nothings/stb/blob/master/stb_image_resize2.h) | Resizing images |\n| [stb_truetype](https://github.com/nothings/stb/blob/master/stb_truetype.h) | Loading font glyphs from font files |\n| [cglm](https://github.com/recp/cglm) | Linear Algebra Math | \n| [GLFW](https://github.com/glfw/glfw) | Handling windowing, input etc. | \n| [libclipboard](https://github.com/jtanx/libclipboard) | Copy + Paste for input fields |\n\n\n## Features\n\n- [x] Creating multiple playlists\n- [x] Playing mp3 music files\n- [x] Playlist controls\n- [x] Adjusting UI for different window resoultions\n- [x] Deleting Playlists\n- [x] Deleting files in Playlist\n- [x] Loading files into playlists dynamically\n- [x] Downloading playlists from streaming services \n- [x] Playlist Shuffle Mode\n- [x] Replay mode for tracks\n- [x] Fullscreened Tracks\n- [x] Searching Playlists for Files\n- [x] Moving files in playlists\n\n## Build Instructions\n\n### Notes \n- Lyssa is currently only able to build (easily) on linux system at the moment\n\n### Installation\n```console\ngit clone https://github.com/cococry/lyssa\ncd lyssa\n./install.sh\n```\n\nThis will install \u0026 build all the depdencies before installing\nlyssa onto your system.\n\nUninstalling\n```\nsudo make uninstall\n```\n\n### Running the Application\n```console\nlyssa \n```\n\n## Contributing\nYou can contribute to Lyssa by:\n  - [Fixing bugs or contributing to features](https://github.com/cococry/lyssa/issues)\n  - [Changing features or adding new functionality](https://github.com/cococry/lyssa/pulls)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcococry%2Flyssa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcococry%2Flyssa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcococry%2Flyssa/lists"}