# KakaoTalk One-Shot Installer for Linux

## Contents

### Table of contents

<!-- toc -->

- [Quick Start (빠른 설치법)](#quick-start-%EB%B9%A0%EB%A5%B8-%EC%84%A4%EC%B9%98%EB%B2%95)
  - [Arch Linux (아치리눅스)](#arch-linux-%EC%95%84%EC%B9%98%EB%A6%AC%EB%88%85%EC%8A%A4)
- [Dependencies (준비물 패키지)](#dependencies-%EC%A4%80%EB%B9%84%EB%AC%BC-%ED%8C%A8%ED%82%A4%EC%A7%80)
  - [Arch Linux (아치리눅스)](#arch-linux-%EC%95%84%EC%B9%98%EB%A6%AC%EB%88%85%EC%8A%A4-1)
  - [Debian / Ubuntu (데비안 / 우분투)](#debian--ubuntu-%EB%8D%B0%EB%B9%84%EC%95%88--%EC%9A%B0%EB%B6%84%ED%88%AC)
- [Installation (설치하기)](#installation-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0)
  - [Arch Linux (아치리눅스)](#arch-linux-%EC%95%84%EC%B9%98%EB%A6%AC%EB%88%85%EC%8A%A4-2)
    - [Enable `multilib` repository](#enable-multilib-repository)
    - [Automatic Installation with AUR package manager (AUR 패키지 관리자를 활용한 설치)](#automatic-installation-with-aur-package-manager-aur-%ED%8C%A8%ED%82%A4%EC%A7%80-%EA%B4%80%EB%A6%AC%EC%9E%90%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-%EC%84%A4%EC%B9%98)
    - [Manual Installation (수동 설치)](#manual-installation-%EC%88%98%EB%8F%99-%EC%84%A4%EC%B9%98)
  - [Other Distros (우분투 등 일반적인 리눅스 배포판)](#other-distros-%EC%9A%B0%EB%B6%84%ED%88%AC-%EB%93%B1-%EC%9D%BC%EB%B0%98%EC%A0%81%EC%9D%B8-%EB%A6%AC%EB%88%85%EC%8A%A4-%EB%B0%B0%ED%8F%AC%ED%8C%90)
    - [System-wide Installation (모든 사용자용으로 설치)](#system-wide-installation-%EB%AA%A8%EB%93%A0-%EC%82%AC%EC%9A%A9%EC%9E%90%EC%9A%A9%EC%9C%BC%EB%A1%9C-%EC%84%A4%EC%B9%98)
    - [User-wide Installation (현재 사용자용으로 설치)](#user-wide-installation-%ED%98%84%EC%9E%AC-%EC%82%AC%EC%9A%A9%EC%9E%90%EC%9A%A9%EC%9C%BC%EB%A1%9C-%EC%84%A4%EC%B9%98)
- [Opening KakaoTalk (카카오톡 열기)](#opening-kakaotalk-%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1-%EC%97%B4%EA%B8%B0)
  - [CLI (명령줄 인터페이스를 활용하기)](#cli-%EB%AA%85%EB%A0%B9%EC%A4%84-%EC%9D%B8%ED%84%B0%ED%8E%98%EC%9D%B4%EC%8A%A4%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0)
  - [Xfce](#xfce)
- [Uninstallation (삭제법)](#uninstallation-%EC%82%AD%EC%A0%9C%EB%B2%95)
  - [KakaoTalk (카카오톡)](#kakaotalk-%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1)
  - [KakaoTalk Installer (카카오톡 설치 도우미)](#kakaotalk-installer-%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1-%EC%84%A4%EC%B9%98-%EB%8F%84%EC%9A%B0%EB%AF%B8)
- [LICENSE](#license)

<!-- tocstop -->

This is a simple [`KakaoTalk`](https://www.kakaocorp.com/page/service/service/KakaoTalk) installation script using [`wine`](https://www.winehq.org/).

[`wine`](https://www.winehq.org/)을 활용한 간단한 [카카오톡](https://www.kakaocorp.com/page/service/service/KakaoTalk) 설치 스크립트입니다.

## Quick Start (빠른 설치법)

### Arch Linux (아치리눅스)

```bash
# If you prefer `paru`
paru -S --needed kakaotalk && kakaotalk

# If you prefer `yay`
yay -S --needed kakaotalk && kakaotalk
```

## Dependencies (준비물 패키지)

- bash
- curl
- desktop-file-utils
- wine > 8.0
- xdg-utils

### Arch Linux (아치리눅스)

```bash
sudo pacman -S bash curl desktop-file-utils wine xdg-utils
```

### Debian / Ubuntu (데비안 / 우분투)

```bash
sudo apt-get update
sudo apt-get install bash curl desktop-file-utils wine xdg-utils
```

## Installation (설치하기)

### Arch Linux (아치리눅스)

#### Enable `multilib` repository

Open `/etc/pacman.conf` as sudo, and uncomment `[multilib]` section to enable it.

NOTE: This step would not be needed when new WoW64 mode is enabled by default. (Checked on: Jan 19, 2024)

#### Automatic Installation with AUR package manager (AUR 패키지 관리자를 활용한 설치)

```bash
# If you prefer `paru`
paru -S kakaotalk

# If you prefer `yay`
yay -S kakaotalk
```

#### Manual Installation (수동 설치)

```bash
makepkg -scri
```

### Other Distros (우분투 등 일반적인 리눅스 배포판)

#### System-wide Installation (모든 사용자용으로 설치)

```bash
sudo ./install.sh
```

#### User-wide Installation (현재 사용자용으로 설치)

```bash
. ./install.sh
```

## Opening KakaoTalk (카카오톡 열기)

You can init and open KakaoTalk by choosing **one of the methods below**.
After initialization, a shortcut icon will appear on the desktop so you can open it more conveniently.

**아래의 방법 중 하나를 수행**하여 카카오톡을 초기화 및 실행할 수 있습니다.
초기화 후에는 바탕화면에 바로가기 아이콘이 생기므로 더욱 편리하게 실행할 수 있습니다.

### CLI (명령줄 인터페이스를 활용하기)

```bash
kakaotalk
```

### Xfce

Application Finder -> Search KakaoTalk (카카오톡) -> Open

## Uninstallation (삭제법)

### KakaoTalk (카카오톡)

The script below deletes the directory where wine KakaoTalk is installed.

아래 스크립트는 wine 카카오톡이 설치된 디렉토리를 삭제합니다.

```bash
rm -r ~/.local/share/kakaotalk
```

### KakaoTalk Installer (카카오톡 설치 도우미)

TODO: TBD

추후 추가 예정

## LICENSE

`install.sh`, `kakaotalk` 등 레포지토리 내 스크립트에 라이선스를 명시한 파일의 경우 `The Unlicense` 라이선스가 적용됩니다.

그 외의 **모든 파일**들은 해당 레포지토리에서 라이선스를 적용하지 않습니다.

카카오톡 사용자 약관에 관해서는 다음 링크를 참고해주세요: https://www.kakao.com/ko/terms.html