<br />
<p align="center">
<img src="https://github.com/iAJue/MoeKoeMusic/raw/main/images/logo.png" alt="Logo" width="156" height="156">
<h2 align="center" style="font-weight: 600">MoeKoe Music</h2>

<p align="center">
오픈 소스 간결하고 용모가 높은 쿨도그 제3자 클라이언트
<br />
<a href="https://github.com/iAJue/MoeKoeMusic/" target="blank"><strong>🌎 GitHub창고</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://github.com/iAJue/MoeKoeMusic/releases" target="blank"><strong>📦️ 설치 패키지 다운로드 </strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://MoeJue.cn" target="blank"><strong>💬 블로그 방문 </strong></a>
</p>
<p align="center">
    <a href="https://github.com/iAJue/MoeKoeMusic/README.md" target="blank"><strong>🇨🇳 简体中文</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://github.com/iAJue/MoeKoeMusic/blob/main/docs/README_tw.md" target="blank"><strong>🇨🇳 繁体中文</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://github.com/iAJue/MoeKoeMusic/blob/main/docs/README_ja.md" target="blank"><strong>🇯🇵 日本語</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://github.com/iAJue/MoeKoeMusic/blob/main/docs/README_en.md" target="blank"><strong>🇺🇸 English</strong></a>&nbsp;&nbsp;|&nbsp;&nbsp;
    <a href="https://github.com/iAJue/MoeKoeMusic/blob/main/docs/README_ko.md" target="blank"><strong>🇰🇷 한국어</strong></a>
    <br />
    <br />
  </p>
</p>

![images](https://github.com/iAJue/MoeKoeMusic/raw/main/images/5.png)

## 머리말

일찍이 10년 전후의 모습, 그것은 웹 페이지 QQ를 사용할 때 나는 이미 쿠거우 음악을 사용하기 시작했다 (또한 10여 년의 오랜 팬이다). 그래서 요 몇 년 동안 소장한 노래는 모두 위에 있다.후에 나도 왕이윈이나 QQ음악을 사용하기 시작했고 쿠거우의 노래 리스트를 도입하려고 시도했지만 효과가 모두 만족스럽지 못했다.내가 들은 것은 대부분 일본 만화 OP이다. 많은 노래를 찾을 수 없다.

빙빙 돌다가 결국 쿠거우로 돌아간다. 그러나 Mac에 있는 쿠거우는 종종 재생할 수 없는 상황이 나타날 수 있다. 비록 인터페이스는 아무런 기능이 없지만 아주 좋다.네티즌의 안리하에 나는 지금 줄곧 쿨개의 [개념판](https://t1.kugou.com/d2tBza3CSV2) 에서 노래를 듣고, 또한 시중에서 VIP 노래를 무료로 들을 수 있는 몇 안 되는 음악 재생 소프트웨어입니다.

나는 나의 개인 소개 페이지에서 내가 특히 노래 듣는 것을 좋아한다고 말했다. 특히 일본 만화 OP.어떻게 증명하죠?(이전에 내 웹페이지 플레이리스트도 오랫동안 수리를 하지 않았다.) 그럼 스스로 음악 플레이어를 하나 개발해라.


## ✨ 특징

- ✅ Vue.js 패밀리 버킷으로 개발
- 🔴 쿠거우 계정 로그인 (코드/핸드폰/계정 로그인)
- 📃 가사 표시 지원
- 📻 매일 추천곡
- 🚫🤝 소셜 기능 없음
- 🔗 공식 서버 직접 연결, 타사 API 없음
- ✔️ 매일 VIP 자동 수령, 로그인하면 VIP
- 🎨 테마 색상 전환
- 👋 시작 인사말
- ⚙️ 다중 플랫폼 지원
- 🛠 더 많은 기능 개발 중

## Todo List
- [ ] 📺 뮤직비디오 재생 지원
- [x] 🌚 Light/Dark Mode 자동 전환
- [ ] 👆 Touch Bar 지원
- [ ] 🖥️ PWA 지원, Chrome/Edge에서 주소 표시줄 오른쪽에 있는➕ 컴퓨터에 설치
- [ ] 🟥 Last.fm Scrobble 지원
- [ ] 🎧 지원 Mpris
- [x] ⌨️ 단축키 및 전역 단축키 사용자 정의
- [x] 🤟 다국어 지원
- [ ] 📻 데스크톱 가사
- [ ] ⚙️ 시스템 아키텍처 최적화
- [ ] 🎶 노래, 트랙 리스트 / 모음, 취소

로그를 업데이트하려면 [Commits](https://github.com/iAJue/MoeKoeMusic/commits/main/)

## 📦️ 설치

이 프로젝트의 [Releases](https://github.com/iAJue/MoeKoeMusic/releases) 페이지에서 설치 패키지를 다운로드합니다.

## ⚙️ 개발

1. 본 창고 클론

```sh
git clone https://github.com/iAJue/MoeKoeMusic.git
```

2. 디렉터리에 들어가서 종속성 설치

```sh
cd MoeKoeMusic
npm run install-all
```
3. 개발자 모드 시작
```sh
npm run dev
```
4. 프로젝트 패키지
```sh
npm run build
```
5. 항목 컴파일
- Windows: 
```sh
npm run electron:build:win [기본 NSIS 설치 패키지]
```
-	Linux: 
```sh
npm run electron:build:linux [기본 AppImage 형식]
```
-	macOS: 
```sh
npm run electron:build:macos [기본 Apple Silicon 아키텍처]
```


더 많은 명령은 `package.json` 파일 `scripts`를 참조하십시오.

## 👷‍♂️ 클라이언트 컴파일

Release 페이지에서 장치에 맞는 설치 패키지를 찾지 못하면 다음 단계에 따라 클라이언트를 포장할 수 있습니다.

1. 설치[Node.js](https://nodejs.org/en/) 및 `Node.js` 버전이 > = 18.0.0인지 확인합니다.

2. `git clone 사용https://github.com/iAJue/MoeKoeMusic.git'본 창고를 로컬로 복제합니다.

3. `npm install`을 사용하여 프로젝트 종속성을 설치합니다.
4. API 서버 컴파일
- Windows:
```sh
npm run build:api:win
```
- Linux:
```sh
npm run build:api:linux
```
- macOS:
```sh
npm run build:api:macos
```

1. 다음 명령을 선택하여 적합한 설치 패키지를 포장합니다. 포장된 파일은'/dist_electron'디렉터리에 있습니다.자세한 내용은 [electron-builder 문서](https://www.electron.build/cli)


#### 1. macOS 플랫폼 패키지
- 범용 macOS 패키지(Intel 및 Apple Silicon 듀얼 아키텍처):
```
npm run electron:build -- --mac --universal
```
- Intel 아키텍처만:
```
npm run electron:build -- --mac --x64
```
- Apple Silicon 아키텍처만:
```
npm run electron:build -- --mac --arm64
```


#### 2. Windows 플랫폼 패키지

- 기본 NSIS 설치 패키지(대부분의 Windows 사용자용):
```
npm run electron:build -- --win
```
- Windows용 EXE 파일 및 Squirrel 설치 패키지를 만듭니다.
```
npm run electron:build -- --win --ia32 --x64 --arm64 --target squirrel
```
-- ia32는 32비트 Windows 아키텍처입니다.

---x64는 64비트 Windows 아키텍처입니다.

-- arm64는 ARM Windows 아키텍처(Surface와 같은 장치)입니다.

- Windows용 휴대용 EXE 파일(설치되지 않음) 생성:
```
npm run electron:build -- --win --portable
```

#### 3. Linux 플랫폼 패키지
- 기본 AppImage 형식(대부분의 Linux 배포용):
```
npm run electron:build -- --linux
```
- snap(Ubuntu 및 snap 지원 릴리스용):
```
npm run electron:build -- --linux --target snap
```
- deb(Debian/Ubuntu 시리즈용):
```
npm run electron:build -- --linux --target deb
```
- rpm(Red Hat/Fedora 시리즈용):
```
npm run electron:build -- --linux --target rpm
```

#### 4. 모든 플랫폼 패키지

Windows, macOS 및 Linux를 모두 생성하는 설치 패키지가 필요한 경우 다음 명령을 사용할 수 있습니다.
```
npm run electron:build -- -mwl
```

#### 5. 컴파일 설정 사용자 정의

x64 및 arm64 스키마를 지정하거나 다른 대상 형식을 선택하는 등의 추가 옵션을 추가하여 패키지를 추가로 사용자 지정할 수 있습니다.


## ☑️ 피드백

질문이나 제안이 있으면 issue 또는 pull request를 제출하십시오.

## 면책 조항
0. 본 프로그램은 쿠거우 제3자 클라이언트입니다. 쿠거우 공식이 아닙니다. 더 완벽한 기능이 필요하시면 공식 클라이언트 체험을 다운로드하십시오.
1.본 프로젝트는 학습용입니다.저작권을 존중하고 이 프로젝트를 상업행위 및 불법용도로 이용하지 마십시오!
2. 본 프로젝트를 사용하는 과정에서 저작권 데이터가 발생할 수 있습니다.본 프로젝트는 이러한 저작권 데이터에 대한 소유권이 없습니다.저작권 침해를 방지하기 위해 사용자는 본 프로젝트를 사용하는 과정에서 발생하는 저작권 데이터를 24시간 이내에 삭제해야 합니다.
3. 본 프로젝트의 사용으로 인해 발생하는 본 계약 또는 본 프로젝트의 사용 또는 사용 불가능으로 인해 발생하는 모든 성격을 포함하는 직접, 간접, 특수, 우연 또는 결과적 손해(상업권 손실, 업무 정지, 컴퓨터 고장 또는 고장으로 인한 손해 배상 또는 기타 모든 상업적 손해 또는 손실을 포함하되 이에 국한되지 않음)는 사용자의 책임이다.
            
1. 현지 법률과 법규를 위반한 경우 본 프로젝트의 사용을 금지한다.사용자가 현지 법률과 법규가 허용하지 않는 것을 뻔히 알거나 모르는 상황에서 본 프로젝트를 사용하여 초래된 어떠한 위법 행위도 사용자가 부담하고 본 프로젝트는 이로 인해 초래된 어떠한 직접, 간접, 특수, 우연 또는 결과적 책임을 지지 않는다.
            
2. 음악 플랫폼은 쉽지 않습니다.저작권을 존중하고 정품을 지원하십시오.
3. 본 프로젝트는 기술적 타당성에 대한 탐구 및 연구에만 사용되며 어떠한 상업(광고 등을 포함하되 이에 국한되지 않음) 합작과 기부도 받지 않습니다.
4.공식 음악 플랫폼이 본 프로젝트가 부적절하다고 생각되면 본 프로젝트에 연락하여 변경하거나 제거할 수 있습니다.
            

## 📜 오픈 소스 라이센스

본 프로젝트는 개인의 학습 연구에만 사용되며 상업 및 불법 용도로 사용되는 것을 금지합니다.

기반 [MIT license](https://opensource.org/licenses/MIT) 오픈 소스로 라이센스를 부여합니다.

## 영감의 원천

API 소스 코드는 [MakcRe/KuGouMusicApi](https://github.com/MakcRe/KuGouMusicApi) 
(원 프로젝트의 구조를 파괴하지 않고 후기 업데이트 반복의 편리를 위해 API는 고도로 통합되지 않았다.~~사실 수고를 덜려고 ~~)

- [Apple Music](https://music.apple.com)
- [YouTube Music](https://music.youtube.com)
- [YesPlayMusic](https://github.com/qier222/YesPlayMusic)
- [쿨도그 뮤직](https://kugou.com/)

## 🖼️ 캡처

![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/1.png)
![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/2.png)
![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/3.png)
![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/4.png)
![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/5.png)
![image](https://github.com/iAJue/MoeKoeMusic/raw/main/images/6.png)
