Quaternion

Windows 설치

Windows에서 Quaternion을 설치하는 방법은 프로젝트의 GitHub Releases 페이지에서 제공하는 아카이브 파일을 다운로드하는 것입니다. 다운로드 후 아카이브를 압축 해제하고 quaternion.exe 파일이 있는 디렉토리에서 직접 실행합니다. Chocolatey 패키지 관리자를 통해서도 설치가 가능합니다.

필수 구성 요소

Quaternion은 동작에 필요한 모든 라이브러리와 C++ 런타임을 패키지에 포함하고 있지만, OpenSSL 라이브러리는 포함되어 있지 않습니다. OpenSSL 3.x(Visual Studio용 빌드)를 별도로 설치해야 SSL 연결 문제가 발생하지 않습니다.

기본 사용법

설치 후 Quaternion을 실행하면 Matrix 서버에 로그인하여 기존 계정을 사용하거나 새 계정을 만들 수 있습니다. 프로그램 실행 시 현재 디렉토리가 quaternion.exe 파일이 있는 디렉토리인지 확인해야 하며, 그렇지 않으면 필요한 라이브러리를 찾지 못해 실행에 실패할 수 있습니다.

주요 설정 옵션

• 알림 설정 (notifications): 알림 방식을 조정할 수 있습니다. ‘none’은 알림을 완전히 비활성화하고, ‘non-intrusive’는 트레이 아이콘에만 알림을 표시하며, ‘intrusive'(기본값)는 창 활성화를 포함한 모든 알림을 표시합니다.
• 타임라인 레이아웃 (timeline_layout): ‘xchat’ 스타일(각 메시지 왼쪽에 작성자 표시) 또는 기본 레이아웃(메시지 블록 위에 작성자 레이블)을 선택할 수 있습니다.
• 셔틀 다이얼 (use_shuttle_dial): 기본값으로 활성화된 셔틀 다이얼은 스크롤바 대신 타임라인을 탐색하는 데 사용됩니다. 중립 위치에서 벗어날수록 스크롤 속도가 빨라지며, 손을 놓으면 자동으로 중립 위치로 돌아갑니다.
• 이미지 자동 로드 (autoload_images): 메시지에 포함된 이미지를 자동으로 로드할지 여부를 설정합니다. 비활성화하면 타임라인에 썸네일만 표시됩니다.

이런 경우에 유용합니다

• Matrix 네트워크 사용자: Matrix 프로토콜을 사용하는 기업이나 개인 사용자를 위한 데스크톱 클라이언트가 필요한 경우에 적합합니다.
• 오픈소스 소프트웨어 선호자: GPL-3.0 라이선스로 배포되는 오픈소스 인스턴트 메시징 솔루션을 찾는 사용자에게 유용합니다.
• 크로스 플랫폼 사용자: 동일한 인터페이스와 기능을 Windows, macOS, Linux에서 모두 사용하고 싶은 사용자에게 적합합니다.

지원 환경

• 운영체제: Windows, macOS, Linux(다양한 배포판 지원)
• 요구사항: Qt 6.4 이상이 필요합니다. Windows에서는 OpenSSL 3.x(Visual Studio용) 추가 설치가 필요합니다.

제한 사항 및 확인 사항

• Windows 사용 시 현재 작업 디렉토리가 quaternion.exe 파일이 있는 디렉토리여야 합니다. %PATH% 변수에 있는 경로에서 실행하면 필요한 라이브러리를 찾지 못할 수 있습니다.
• OpenSSL 라이브러리는 패키지에 포함되어 있지 않으므로 별도로 설치해야 합니다. 특히 Visual Studio용 OpenSSL 3.x 버전을 사용해야 합니다.
• Qt Keychain을 사용하여 접근 토큰과 데이터베이스를 저장하며, 안전한 저장소를 사용할 수 없는 경우 E2EE(End-to-End Encryption)가 자동으로 비활성화됩니다.