{"id":23310652,"url":"https://github.com/dever-m/yami","last_synced_at":"2025-05-16T08:06:04.503Z","repository":{"id":258168135,"uuid":"866353718","full_name":"DevER-M/yami","owner":"DevER-M","description":"An open-source music player with simple UI","archived":false,"fork":false,"pushed_at":"2024-11-24T12:55:58.000Z","size":8275,"stargazers_count":232,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-10T19:19:18.280Z","etag":null,"topics":["customtkinter","hacktoberfest","online-music-player","spotdl","tkinter","youtube-music-player"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/yami-music-player/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevER-M.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-10-02T05:18:55.000Z","updated_at":"2025-05-08T03:11:54.000Z","dependencies_parsed_at":"2025-01-31T20:46:26.393Z","dependency_job_id":"76cca1a9-c2fd-49dd-9b4e-a608909bac29","html_url":"https://github.com/DevER-M/yami","commit_stats":null,"previous_names":["dever-m/yami"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevER-M%2Fyami","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevER-M%2Fyami/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevER-M%2Fyami/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevER-M%2Fyami/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevER-M","download_url":"https://codeload.github.com/DevER-M/yami/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254493378,"owners_count":22080126,"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":["customtkinter","hacktoberfest","online-music-player","spotdl","tkinter","youtube-music-player"],"created_at":"2024-12-20T13:28:43.824Z","updated_at":"2025-05-16T08:05:59.493Z","avatar_url":"https://github.com/DevER-M.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n\n![yami-logo](https://github.com/DevER-M/yami/blob/main/.assets/vector/default-monochrome-black.svg?raw=true)\n---\n![Static Badge](https://img.shields.io/badge/pip_install-yami--music--player-purple)\n![Static Badge](https://img.shields.io/badge/Language-Python-red)\n![GitHub last commit](https://img.shields.io/github/last-commit/DevER-M/yami)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/yami-music-player)\n\n\u003ch3\u003e\n\u003ccode\u003eyami\u003c/code\u003e | An open-source music player with simple UI\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\nDownload or play music locally without ads!   \n\u003c/p\u003e\n\n[Installation](#installation) • [Usage](#usage) • [Features](#features) • [Contributing](#contributing) • [License](#license)\n\u003c/div\u003e\n\n## 🔍Overview\n`Yami` is a lightweight, open-source music player built in Python. It focuses on simplicity and ease of use, providing an intuitive user interface (UI) for users to manage and play their music. Whether you're playing local files or downloading from online sources using spotdl, Yami offers a seamless experience. This project is designed for users who want a minimalistic, cross-platform music player with the ability to integrate external sources like Spotify/Youtube Music.\n\n## 📸Screenshot\n\u003cdiv align=\"center\"\u003e\n\u003cimg align=\"center\" src=\"https://github.com/DevER-M/yami/blob/main/.assets/pic.png?raw=true\"\u003e\n\u003cimg align=\"center\" src=\"https://github.com/DevER-M/yami/blob/main/.assets/example.gif?raw=true\"\u003e\n\u003c/div\u003e\n\n\n\n\n## 🛠️ Getting Started\n\n### Prerequisites\n- **Python** 3.8+\n- **pip** for dependency management\n\n### Installation\n#### From Pip\n```sh\npip install yami-music-player\n```\n#### From Github\n##### 1. Clone the Repository\n```sh\ngit clone https://github.com/DevER-M/yami.git\ncd yami\n```\n##### 2. Create and activate a virtual environment:\n```sh\npython -m venv venv\nsource venv/bin/activate  # On Windows, use `venv\\Scripts\\activate`\n```\n\n3. Install `yami-music-player` (in editable mode):\n```sh\npip install -e .\n```\n\n\n\n# Usage\n\nTo run `yami`, use the following command in your terminal:\n\n```sh\n$ yami \n# Or\n$ python -m yami\n```\n\n## Features\n\n- **Spotdl Integration:** Download music directly from the app using spotdl\n  - **Asynchronous Downloading :** From synchronous `spotdl.Downloader.search_and_download()`\n- **Player Controls:**\n  - **\u003cimg src=\"https://github.com/DevER-M/yami/blob/main/yami/data/pause.png?raw=true\" alt=\"drawing\" width=\"30\" style=\"vertical-align:bottom\"\u003e :** Pause/play music\n  - **\u003cimg src=\"https://github.com/DevER-M/yami/blob/main/yami/data/skip_next.png?raw=true\" alt=\"drawing\" width=\"30\" style=\"vertical-align:bottom\"\u003e :** Play next song\n  - **\u003cimg src=\"https://github.com/DevER-M/yami/blob/main/yami/data/skip_prev.png?raw=true\" alt=\"drawing\" width=\"30\" style=\"vertical-align:bottom\"\u003e :** Play previous song\n  - **\u003cimg src=\"https://github.com/DevER-M/yami/blob/main/yami/data/folder.png?raw=true\" alt=\"drawing\" width=\"30\" style=\"vertical-align:bottom\"\u003e :** Choose folder\n  - **\u003cimg src=\"https://github.com/DevER-M/yami/blob/main/yami/data/music.png?raw=true\" alt=\"drawing\" width=\"30\" style=\"vertical-align:bottom\"\u003e :** Download music\n  - **`ctrl+o` :** Choose folder\n\nThis will open the app, for the logs check the terminal.\n\n# Contributing\n\nContributions are welcome and greatly appreciated! Here's how you can contribute:\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n# License\n\nDistributed under the GPLV3 License. See [`LICENSE`](LICENSE) for more information.\n\n# Discussions\n\nDiscussions are available and can be used for feature requests and questions\n\n\n# Credits\n- [Custom Tkinter](https://github.com/TomSchimansky/CustomTkinter)\n- [Spotdl](https://github.com/spotDL/spotify-downloader)\n- [@ElSaico](https://github.com/ElSaico) for fixing [locale scaling](https://github.com/ElSaico/CustomTkinter/tree/fix-locale-scaling)\n\n## Star History\n[![Star History Chart](https://api.star-history.com/svg?repos=DevER-M/yami\u0026type=Date)](https://api.star-history.com/svg?repos=DevER-M/yami\u0026type=Date)\n\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdever-m%2Fyami","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdever-m%2Fyami","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdever-m%2Fyami/lists"}