Skip to content

Commit

Permalink
Merge pull request #592 from corydalis10/master
Browse files Browse the repository at this point in the history
Update README.md & README_kor.md
  • Loading branch information
timschneeb authored Feb 2, 2025
2 parents a38f465 + 36fd622 commit 6a0637f
Show file tree
Hide file tree
Showing 2 changed files with 109 additions and 57 deletions.
19 changes: 10 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@

<p align="center">
<span><a href="https://ko-fi.com/H2H83E5J3"><img alt="Screenshot" src="https://ko-fi.com/img/githubbutton_sm.svg"></a>
<a href="#"><img alt="Screenshot" src="https://github.com/timschneeb/GalaxyBudsClient/blob/master/screenshots/app_dark.png"></a></span>
<a href="#"><img alt="Screenshot" src="https://github.com/timschneeb/GalaxyBudsClient/raw/master/screenshots/app_dark.png"></a></span>
</p>

## Key Features
Expand Down Expand Up @@ -61,12 +61,12 @@ Get binaries for Windows in the [release](https://github.com/timschneeb/GalaxyBu

Download the desktop version here:
<p align="center">
<a href="https://github.com/timschneeb/GalaxyBudsClient/releases"><img alt="Download" src="https://github.com/timschneeb/GalaxyBudsClient/blob/master/screenshots/download.png"></a>
<a href="https://github.com/timschneeb/GalaxyBudsClient/releases"><img alt="Download" src="https://github.com/timschneeb/GalaxyBudsClient/raw/master/screenshots/download.png"></a>
</p>

Download the Android mobile version here (paid):
<p align="center">
<a href='https://play.google.com/store/apps/details?id=me.timschneeberger.galaxybudsclient&utm_source=github&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'>
<a href='https://play.google.com/store/apps/details?id=me.timschneeberger.galaxybudsclient&utm_source=github&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'>
<img width="300" alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png'/>
</a>
</p>
Expand All @@ -84,7 +84,7 @@ flatpak install me.timschneeberger.GalaxyBudsClient

> **Note**: Flatpaks are sandboxed. This application can only access `~/.var/app/me.timschneeberger.GalaxyBudsClient/` by default.
### AUR package
### AUR package

An [AUR package](https://aur.archlinux.org/packages/galaxybudsclient-bin/) for Arch Linux maintained by @joscdk is also available:
```
Expand Down Expand Up @@ -157,6 +157,7 @@ If you want to contribute your own code, you can simply submit a plain pull requ
* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Russian and Ukrainian translation
* [@PlasticBrain](https://github.com/fhalfkg) - Korean and Japanese translation
* [@cozyplanes](https://github.com/cozyplanes) - Korean translation
* [@corydalis10](https://github.com/corydalis10) - Korean translation
* [@erenbektas](https://github.com/erenbektas) and [@Eta06](https://github.com/Eta06) - Turkish translation
* [@kakkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad), [@pseudor](https://github.com/pseudor) and [@YexuanXiao](https://github.com/YexuanXiao) - Chinese translation
* [@YiJhu](https://github.com/YiJhu) - Chinese-Traditional translation
Expand All @@ -177,7 +178,7 @@ If you want to contribute your own code, you can simply submit a plain pull requ

### Services

* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license
* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license

### Assets
* Earbud asset used in the Android icon created by [Archival](https://www.flaticon.com/authors/archival) from [Flaticon](https://www.flaticon.com/)
Expand All @@ -187,9 +188,9 @@ If you want to contribute your own code, you can simply submit a plain pull requ
This project is licensed under [GPLv3](https://github.com/timschneeb/GalaxyBudsClient/blob/master/LICENSE). It is not affiliated with Samsung nor supervised by them in any way.

```
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
THE USE OR OTHER DEALINGS IN THE SOFTWARE.
```
147 changes: 99 additions & 48 deletions docs/README_kor.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@
Galaxy Buds Client
<br>
</h1>
<h4 align="center">버즈, 버즈 플러스, 버즈 라이브와 버즈 프로를 위한 비공식 매니저</h4>
<h4 align="center">갤럭시 버즈 기기를 위한 비공식 매니저</h4>
<p align="center">
<a href="https://github.com/ThePBone/GalaxyBudsClient/releases">
<a href="https://github.com/timschneeb/GalaxyBudsClient/releases">
<img alt="Github 다운로드 횟수" src="https://img.shields.io/github/downloads/thepbone/galaxybudsclient/total">
</a>
<a href="https://github.com/ThePBone/GalaxyBudsClient/releases">
<img alt="GitHub 릴리즈 (최신 날짜)" src="https://img.shields.io/github/v/release/thepbone/galaxybudsclient">
<a href="https://github.com/timschneeb/GalaxyBudsClient/releases">
<img alt="GitHub 릴리즈 (최신)" src="https://img.shields.io/github/v/release/thepbone/galaxybudsclient">
</a>
<a href="https://github.com/ThePBone/GalaxyBudsClient/blob/master/LICENSE">
<a href="https://github.com/timschneeb/GalaxyBudsClient/blob/master/LICENSE">
<img alt="라이센스" src="https://img.shields.io/github/license/thepbone/galaxybudsclient">
</a>
<a href="https://github.com/ThePBone/GalaxyBudsClient/releases">
<img alt="플랫폼" src="https://img.shields.io/badge/platform-Windows/Linux-yellowgreen">
<a href="https://github.com/timschneeb/GalaxyBudsClient/releases">
<img alt="플랫폼" src="https://img.shields.io/badge/platform-Windows/macOS/Linux/Android-yellowgreen">
</a>
</p>
<p align="center">
Expand All @@ -27,15 +27,12 @@
<a href="#동작-방식">동작 방식</a> •
<a href="#기여">기여</a> •
<a href="#제작자">제작자</a> •
<a href="#라이선스">라이선스</a>
<a href="#라이선스">라이선스</a>
</p>

<p align="center">
<a href="https://ko-fi.com/H2H83E5J3"><img alt="스크린샷" src="https://ko-fi.com/img/githubbutton_sm.svg"></a>
</p>

<p align="center">
<a href="#"><img alt="스크린샷" src="https://github.com/ThePBone/GalaxyBudsClient/blob/master/screenshots/screencap.gif"></a>
<span><a href="https://ko-fi.com/H2H83E5J3"><img alt="스크린샷" src="https://ko-fi.com/img/githubbutton_sm.svg"></a>
<a href="#"><img alt="스크린샷" src="https://github.com/timschneeb/GalaxyBudsClient/raw/master/screenshots/app_dark.png"></a></span>
</p>

## 주요 기능
Expand All @@ -52,15 +49,51 @@

## 다운로드

Windows와 Linux 바이너리는 [릴리즈 섹션](https://github.com/ThePBone/GalaxyBudsClient/releases)에서 다운로드가 가능합니다. 설치하기 전에 릴리즈 노트를 읽어 주세요.
몇 가지 Linux 패키지를 사용할 수 있습니다:
* [Flatpak (모든 Linux 배포판)](#flatpak)
* [AUR 패키지 (아치 리눅스)](#aur-package)

Windows용 바이너리는 [릴리즈](https://github.com/timschneeb/GalaxyBudsClient/releases) 섹션에 있습니다. 설치하기 전에 릴리스 노트를 읽어주세요.

여기에서 데스크톱 버전을 다운로드하세요:
<p align="center">
<a href="https://github.com/ThePBone/GalaxyBudsClient/releases"><img alt="다운로드" src="https://github.com/ThePBone/GalaxyBudsClient/raw/master/screenshots/download.png"></a>
</p>

여기에서 안드로이드용 모바일 버전을 다운로드하세요 (유료):
<p align="center">
<a href="https://github.com/ThePBone/GalaxyBudsClient/releases"><img alt="다운로드" src="https://github.com/ThePBone/GalaxyBudsClient/blob/master/screenshots/download.png"></a>
<a href='https://play.google.com/store/apps/details?id=me.timschneeberger.galaxybudsclient&utm_source=github&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'>
<img width="300" alt='Google Play에서 받기' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png'/>
</a>
</p>

Windows 패키지는 Windows Package Manager(winget)로도 설치가 가능합니다.
### Flatpak

모든 Linux 배포판을 위한 범용 바이너리 패키지입니다. Flatpak 버전은 수동으로 설정하지 않는 한 자동 시작을 지원하지 않습니다. 'galaxybudsclient /StartMinimized'를 사용하여 시작 시 앱을 자동으로 실행할 수 있습니다.

FlatHub에서 다운로드 가능: https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient
```
flatpak install me.timschneeberger.GalaxyBudsClient
```

<a href='https://flathub.org/apps/me.timschneeberger.GalaxyBudsClient'><img width='240' alt='Flathub에서 다운로드하기' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/></a>

> **노트**: Flatpak은 샌드박스가 적용되었습니다. 이 애플리케이션은 기본적으로 `~/.var/app/me.timschneeberger.GalaxyBudsClient/`에만 접근할 수 있습니다.
### AUR 패키지

@joscdk가 유지 관리하는 Arch Linux용 [AUR 패키지](https://aur.archlinux.org/packages/galaxybudsclient-bin/)도 사용할 수 있습니다:
```
yay -S galaxybudsclient-bin
```

### winget

Windows 패키지는 Windows 패키지 관리자 (winget)로도 설치할 수 있습니다.

`winget install ThePBone.GalaxyBudsClient`
```
winget install timschneeb.GalaxyBudsClient
```

## 동작 방식

Expand All @@ -70,11 +103,11 @@ Bluetooth 무선 기술을 사용하기 위해, 디바이스는 동작 가능한

A2DP 프로필이 표준화 및 문서화되더라도, RFCOMM 프로토콜로 교환되는 실제 바이너리 데이터의 형식은 일반적으로 문서화되지 않은 독자적 형식입니다.

이 데이터 형식을 역분석하기 위해, 저는 이어버즈로부터 전송되는 바이너리 스트림을 분석하기 시작했습니다. 그 후에는 디바이스들의 내부 동작을 더 자세히 알기 위해 안드로이드 공식 갤럭시 버즈 앱을 분석했습니다. 이 일을 하는 동안, 저는 제가 했던 생각들을 기록했습니다. 별로 아름다운 기록은 아니지만, 밑에 링크를 기재했습니다. 제가 상세한 내용 하나 하나에 대해서 모두 기록하지는 않았음을 알아두세요. 프로토콜에 대해 더 자세한 정보를 알고 싶다면 소스 코드를 확인하세요.
이 데이터 형식을 역분석하기 위해, 저는 이어버드로부터 전송되는 바이너리 스트림을 분석하기 시작했습니다. 그 후에는 디바이스들의 내부 동작을 더 자세히 알기 위해 안드로이드 공식 갤럭시 버즈 앱을 분석했습니다. 이 일을 하는 동안, 저는 제가 했던 생각들을 기록했습니다. 별로 아름다운 기록은 아니지만, 밑에 링크를 기재했습니다. 제가 상세한 내용 하나 하나에 대해서 모두 기록하지는 않았음을 알아두세요. 프로토콜에 대해 더 자세한 정보를 알고 싶다면 소스 코드를 확인하세요.

<p align="center">
<a href="https://github.com/ThePBone/GalaxyBudsClient/blob/master/GalaxyBudsRFCommProtocol.md">갤럭시 버즈 (2019) 기록</a> •
<a href="https://github.com/ThePBone/GalaxyBudsClient/blob/master/Galaxy%20Buds%20Plus%20RFComm%20Protocol%20Notes.md">갤럭시 버즈 플러스 기록</a>
<a href="https://github.com/ThePBone/GalaxyBudsClient/blob/master/GalaxyBudsRFCommProtocol.md">갤럭시 버즈 (2019) 노트</a> •
<a href="https://github.com/ThePBone/GalaxyBudsClient/blob/master/Galaxy%20Buds%20Plus%20RFComm%20Protocol%20Notes.md">갤럭시 버즈 플러스 노트</a>
</p>

갤럭시 버즈 플러스를 유심히 분석하면서, 저는 펌웨어 디버그 모드와 쓰이지 않은 페어링 모드, Bluetooth 키 덤퍼와 같은 특이한 기능을 찾아냈습니다. 그 기능들에 대한 내용도 아래의 링크에 기록했습니다:
Expand All @@ -90,46 +123,64 @@ A2DP 프로필이 표준화 및 문서화되더라도, RFCOMM 프로토콜로
<a href="https://github.com/ThePBone/GalaxyBudsFirmwareExtractor">펌웨어 추출기</a>
</p>

이 스크립트를 사용하여 버즈 프로에서 헤드 트래킹 데이터를 실시간으로 스트리밍하세요: [timschneeb/BudsPro-Headtracking](https://github.com/timschneeb/BudsPro-Headtracking)

## 기여

기능 요청, 버그 보고, Pull Requests 등 어떤 형태의 기여도 환영합니다.

버그를 제보하거나 아이디어를 제시하고 싶으시면, 템플릿과 함께 제공되는 [새로운 Issue 생성](https://github.com/ThePBone/GalaxyBudsClient/issues/new/choose)을 이용해 주세요. [위키](https://github.com/ThePBone/GalaxyBudsClient/wiki/2.-How-to-submit-issues)를 방문해 자세한 설명을 참고하세요.
버그를 제보하거나 아이디어를 제시하고 싶으시면, 템플릿과 함께 제공되는 [새로운 Issue 생성](https://github.com/timschneeb/GalaxyBudsClient/issues/new/choose)을 이용해 주세요. [위키](https://github.com/timschneeb/GalaxyBudsClient/wiki/2.-How-to-submit-issues)를 방문해 자세한 설명을 참고하세요.

이 프로그램의 번역에 도움을 제공하고 싶으시다면, [위키의 설명](https://github.com/timschneeb/GalaxyBudsClient/wiki/3.-How-to-help-with-translations)을 참조하세요. 프로그래밍 지식을 요구하지 않으며, Pull Request 전 어떤 개발 툴의 설치도 없이 번역을 테스트할 수 있습니다.
번역에 대한 자동 생성 진행률 보고서는 [여기](https://github.com/timschneeb/GalaxyBudsClient/blob/master/meta/translations.md)에서 확인할 수 있습니다.

이 프로그램의 번역에 도움을 제공하고 싶으시다면, [위키의 설명](https://github.com/ThePBone/GalaxyBudsClient/wiki/3.-How-to-help-with-translations)을 참조하세요. 프로그래밍 지식을 요구하지 않으며, Pull Request 전 어떤 개발 툴의 설치도 없이 번역을 테스트할 수 있습니다.
소스 코드에 기여하고 싶으시다면, 변경한 내용에 대한 Pull Request를 생성하면 됩니다. 프로그램에 대한 크거나 민감한 기여 사항은 작업을 시작하기 전에 Issue를 생성해 주세요. (또는 텔레그램 [@thepbone](https://t.me/thepbone)으로 연락)

## 제작자

#### 기여

- [@ArthurWolfhound](https://github.com/ArthurWolfhound) - Issue 템플릿, 위키 제작과 번역
- [@AndriesK](https://github.com/AndriesK) - 버즈 라이브 버그 픽스
- [@TheLastFrame](https://github.com/TheLastFrame) - 버즈 프로 아이콘
- [@githubcatw](https://github.com/githubcatw) - 연결 알림 기반 제작
- [@GaryGadget9](https://github.com/GaryGadget9) - WinGet 패키지

#### 번역

- [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 러시아어, 우크라이나어 번역
- [@BrainInAVet](https://github.com/fhalfkg) - 한국어, 일본어 번역
- [@cozyplanes](https://github.com/cozyplanes) - 한국어 번역
- [@erenbektas](https://github.com/erenbektas) - 터키어 번역
- [@kakkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad) and [@pseudor](https://github.com/pseudor) - 중국어 번역
- [@efrenbg1](https://github.com/efrenbg1), Andrew Gonza - 스페인어 번역
- [@giovankabisano](https://github.com/giovankabisano) - 인도네시아어 번역
- [@lucasskluser](https://github.com/lucasskluser) - 포르투갈어 번역
- [@alb-p](https://github.com/alb-p), [@mario-donnarumma](https://github.com/mario-donnarumma) - 이탈리아어 번역
- [@Buashei](https://github.com/Buashei) - 폴란드어 번역
- [@KatJillianne](https://github.com/KatJillianne), [@thelegendaryjohn](https://github.com/thelegendaryjohn) - 베트남어 번역
- [@joskaja](https://github.com/joskaja), [@Joedmin](https://github.com/Joedmin) - 체코어 번역
- [@TheLastFrame](https://github.com/TheLastFrame), [@ThePBone](https://github.com/ThePBone) - 독일어 번역
- [@nikossyr](https://github.com/nikossyr) - 그리스어 번역
- [@grigorem](https://github.com/grigorem) - 루마니아어 번역
#### 기여자

* [@nift4](https://github.com/nift4) - macOS 지원 및 버그 수정
* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 이슈 템플릿, 위키 및 번역
* [@AndriesK](https://github.com/AndriesK) - 버즈 라이브 버그 수정
* [@TheLastFrame](https://github.com/TheLastFrame) - 버즈 프로 아이콘
* [@githubcatw](https://github.com/githubcatw) - 연결 대화 상자 기반
* [@GaryGadget9](https://github.com/GaryGadget9) - WinGet 패키지
* [@joscdk](https://github.com/joscdk) - AUR 패키지

#### 번역가

* [@ArthurWolfhound](https://github.com/ArthurWolfhound) - 러시아어 및 우크라이나어 번역
* [@PlasticBrain](https://github.com/fhalfkg) - 한국어 및 일본어 번역
* [@cozyplanes](https://github.com/cozyplanes) - 한국어 번역
* [@erenbektas](https://github.com/erenbektas)[@Eta06](https://github.com/Eta06) - 터키어 번역
* [@kakkkk](https://github.com/kakkk), [@KevinZonda](https://github.com/KevinZonda), [@ssenkrad](https://github.com/ssenkrad), [@pseudor](https://github.com/pseudor)[@YexuanXiao](https://github.com/YexuanXiao) - 중국어 번역
* [@YiJhu](https://github.com/YiJhu) - 중국어-전통 번역
* [@efrenbg1](https://github.com/efrenbg1) 및 Andrew Gonza - 스페인어 번역
* [@giovankabisano](https://github.com/giovankabisano) - 인도네시아어 번역
* [@lucasskluser](https://github.com/lucasskluser) - 포르투갈어 번역
* [@alb-p](https://github.com/alb-p), [@mario-도나룸마](https://github.com/mario-donnarumma) - 이탈리아어 번역
* [@Buashei](https://github.com/Buashei) - 폴란드어 번역
* [@KatJillianne](https://github.com/KatJillianne)[@theLegendaryjohn](https://github.com/thelegendaryjohn) - 베트남어 번역
* [@jos카자](https://github.com/joskaja)[@Joedmin](https://github.com/Joedmin) - 체코어 번역
* [@Benni0109](https://github.com/Benni0109), [@TheLastFrame](https://github.com/TheLastFrame), [@timschneeb](https://github.com/timschneeb) - 독일어 번역
* [@nikossyr](https://github.com/nikossyr) - 그리스어 번역
* [@grigorem](https://github.com/grigorem) - 루마니아어 번역
* [@tretre91](https://github.com/tretre91) - 프랑스어 번역
* [@Sigarya](https://github.com/Sigarya) - 히브리어 번역
* [@domroaft](https://github.com/domroaft) - 헝가리어 번역
* [@lampi8426](https://github.com/lampi8426) - 네덜란드어 번역

### 서비스

* [Cloudflare](https://www.cloudflare.com/) - Secures the backend APIs of GalaxyBudsClient and provided a Pro license

### 요소
* [Flaticon](https://www.flaticon.com/)[Archival](https://www.flaticon.com/authors/archival)이 만든 안드로이드 아이콘에 사용된 이어버드 에셋입니다.

## 라이선스

이 프로젝트는 [GPLv3](../LICENSE) 라이선스를 따릅니다. 삼성과 관련되지 않았으며 그 어떤 권고나 제한도 받지 않습니다.
이 프로젝트는 [GPLv3](../LICENSE) 라이선스를 따릅니다. 삼성과 관련되지 않았으며 그들에게 어떠한 권고나 제한도 받지 않습니다.

```
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
Expand Down

0 comments on commit 6a0637f

Please sign in to comment.