{"id":31124206,"url":"https://github.com/organization/lyrs","last_synced_at":"2025-09-17T19:38:47.206Z","repository":{"id":176866918,"uuid":"659391737","full_name":"organization/lyrs","owner":"organization","description":"Lyrs: Shows the lyrics of the track, playing on Spotify / YouTube Music","archived":false,"fork":false,"pushed_at":"2025-09-17T05:39:07.000Z","size":15891,"stargazers_count":99,"open_issues_count":26,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-09-17T07:22:55.501Z","etag":null,"topics":["electron","hacktoberfest","lyrics","solidjs","spotify","typescript","vite","youtube-music"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/organization.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-27T18:25:30.000Z","updated_at":"2025-09-15T12:46:57.000Z","dependencies_parsed_at":"2023-12-13T20:53:02.910Z","dependency_job_id":"11ab87eb-6011-4cc7-a173-98baace325ac","html_url":"https://github.com/organization/lyrs","commit_stats":null,"previous_names":["organization/alspotron","organization/lyrs"],"tags_count":66,"template":false,"template_full_name":null,"purl":"pkg:github/organization/lyrs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/organization%2Flyrs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/organization%2Flyrs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/organization%2Flyrs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/organization%2Flyrs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/organization","download_url":"https://codeload.github.com/organization/lyrs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/organization%2Flyrs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275650118,"owners_count":25503228,"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","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["electron","hacktoberfest","lyrics","solidjs","spotify","typescript","vite","youtube-music"],"created_at":"2025-09-17T19:38:41.622Z","updated_at":"2025-09-17T19:38:47.194Z","avatar_url":"https://github.com/organization.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://github.com/organization/lyrs/assets/16558115/447a957e-faf2-4759-8884-5d7b04fb1fbb\" width=\"2%\" /\u003e Lyrs \u003ca href=\"https://github.com/organization/lyrs/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/organization/lyrs/total.svg\"/\u003e\u003c/a\u003e\n\n### 커스텀이 편리한 *Spotify*, *YouTube Music* 가사 표시기\n\n\u003e `스포티파이` 혹은 `유튜브 뮤직`등의 `뮤직 플레이어`에서 재생중인 노래의 가사를 화면에 표시해줍니다.\n\n### Screenshot\n\n-   동영상 위에 가사가 표시되게 촬영한 예시 이미지이며, 실제로는 위치를 자유롭게 선택할 수 있습니다.\n\n|                        Spotify                         |                                                        Youtube Music                                                        |\n|:------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------:|\n| ![Spotify Screenshot](https://i.imgur.com/0JJMhaU.png) | ![YouTube Music Screenshot](https://github.com/organization/lyrs/assets/16558115/fc22323e-d0b2-4abc-882e-2281c13f4cf4) |\n|                                         Game Overlay (tested game: Overwatch)                                         | |\n| ![Overlay Screenshot](https://github.com/organization/lyrs/assets/16558115/7bb95071-b8f7-45e1-af59-02e1586d5dcc) | |\n\n## Installation\n\n설치 방법은 다음과 같습니다.\n\n### Spotify\n\n#### 1.  [Spicetify 설치](https://github.com/khanhas/spicetify-cli)\n-   다음 링크의 지시사항에 따라 `Spicetify`를 설치해주세요.\n\n#### 2.  [Lyrs 다운로드](https://github.com/organization/lyrs/releases)\n\n-   Release 탭에서 최신버전의 Lyrs을 다운로드한 후 설치해주세요. (포터블 버전은 설정이 저장되지 않습니다)\n-   Windows 사용자께서는 `Lyrs-Web-Setup-[version].exe`을 다운로드 받으시면 됩니다.\n\n#### 3.  Lyrs Companion 설치\n| 1. 플러그인 설정 | 2. 확장 설치 버튼 누르기 |\n|:------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------:|\n| ![image](https://github.com/user-attachments/assets/e19f25f0-54f5-4ec5-9d4f-b1569fcd1c19) | ![image](https://github.com/user-attachments/assets/50003f4b-6e3d-434f-9f45-2d9d13dd0912) |\n\n\u003e [!NOTE]\n\u003e 플러그인이 존재하지 않는다면 아래 **수동 설치 방법**을 확인해주세요\n\n\u003cdetails\u003e\n  \u003csummary\u003e\n    수동 설치 방법\n  \u003c/summary\u003e\n\n-   [Spicetify 설치 위치의 Extensions](https://spicetify.app/docs/advanced-usage/extensions/) 폴더에 [`lyrs.js`를 다운로드 받아](https://powernukkit.github.io/DownGit/#/home?directFile=1\u0026url=https://github.com/organization/lyrs/blob/master/extensions/lyrs.js) 넣어주세요.\n-   아래 명령어를 사용하여 `lyrs.js` 확장을 `Spicetify`에 추가합니다.\n    ```bash\n    spicetify config extensions lyrs.js\n    ```\n-   그 뒤, 아래 명령을 사용하면 `Spotify`가 다시 시작되고 `lyrs.js` 확장 프로그램이 적용됩니다.\n    ```bash\n    spicetify apply\n    ``` \n\n\u003c/details\u003e\n\n---\n\n### YouTube Music\n\n1.  [YouTube Music Desktop 설치](https://github.com/th-ch/youtube-music/releases)\n\n  -   다음 링크의 지시사항에 따라 `Youtube Music Desktop`을 설치해주세요.\n\n2.  `Youtube Music Desktop`을 실행하고, 상단 메뉴의 `plugins`를 클릭한 뒤 `tuna-obs`를 활성화해주세요.\n\n3.  [Lyrs 다운로드](https://github.com/organization/lyrs/releases)\n\n  -   Release 탭에서 최신버전의 Lyrs을 다운로드한 후 설치해주세요.\n  -   Windows 사용자께서는 `Lyrs-Web-Setup-[version].exe`을 다운로드 받으시면 됩니다.\n\n---\n\n### 그 외 플레이어 (e.g. Apple Music)\n\n#### 1.  [tuna-obs](https://github.com/univrsal/tuna)를 참고하여 브라우저 확장 프로그램을 (tempermonkey script) 설치해주세요.\n#### 2.  [Lyrs 다운로드](https://github.com/organization/lyrs/releases)\n-   Release 탭에서 최신버전의 Lyrs을 다운로드한 후 설치해주세요.\n-   Windows 사용자께서는 `Lyrs-Web-Setup-[version].exe`을 다운로드 받으시면 됩니다.\n\n---\n\n### 마지막 단계\n\n#### Windows, Linux\n\n-   `Lyrs` 실행\n\n#### macOS\n\n-   `손상되었기 때문에 열 수 없습니다.` 메시지가 뜨고 앱이 실행되지 않는다면, 다음 명령어를 터미널에 입력하세요.\n    ```bash\n    xattr -cr /Applications/Lyrs.app\n    ```\n-   혹은 [해당 링크](https://archivers.tistory.com/74)를 참고하여 실행하세요.\n\n## Config\n\n1.  설정\n\n|                                                   일반 설정                                                  |                                                   위치 설정                                                  |\n| :------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------: |\n| ![lyrs-settings-general](https://github.com/organization/lyrs/assets/13764936/8e4ec704-d533-4d82-ad60-ffa3f0793a9c) | ![lyrs-settings-position](https://github.com/organization/lyrs/assets/13764936/70f1fc41-0497-4b48-b3de-d745e7bb7c0b) |\n|                                                   테마 설정                                                  |                                                   테마 상세 설정                                                  |\n| ![lyrs-settings-theme-list](https://github.com/organization/lyrs/assets/13764936/c7d0436f-7bfa-4b36-a89e-dab36d0948bd) | ![lyrs-settings-theme](https://github.com/organization/lyrs/assets/13764936/f47f9483-411d-4536-b6bc-1e73655de254) |\n|                                                   플러그인 설정                                                  |\n| ![lyrs-settings-plugin](https://github.com/organization/lyrs/assets/13764936/dae59ec5-e9ea-49d7-bc5e-20a78a867d22) |\n\n2.  트레이 아이콘의 `가사 선택`을 선택하여 현재 재생 중인 노래의 가사를 다른 가사로 교체할 수 있습니다.\n\n|                                          곡을 검색하고, 다른 가사를 적용한 예제                                          |\n| :------------------------------------------------------------------------------------------------------: |\n| ![image](https://github.com/organization/lyrs/assets/16558115/171d97b3-79ff-4ede-b7a6-9905b7993b42) |\n\n## Plugin\n[문서](https://github.com/organization/lyrs/wiki/Plugin)를 참고하세요.\n\n예제는 [여기](https://github.com/organization/lyrs/tree/master/example/lyrs-plugin)를 확인해주세요.\n\n\n## LICENSE\n\n`Apache License 2.0`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forganization%2Flyrs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forganization%2Flyrs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forganization%2Flyrs/lists"}