https://github.com/ioriayane/hagoromo
This is a multi-column Bluesky client.
https://github.com/ioriayane/hagoromo
bluesky bluesky-app bluesky-client qt qtquick
Last synced: about 1 year ago
JSON representation
This is a multi-column Bluesky client.
- Host: GitHub
- URL: https://github.com/ioriayane/hagoromo
- Owner: ioriayane
- License: mit
- Created: 2023-04-29T15:57:41.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T16:29:59.000Z (about 1 year ago)
- Last Synced: 2025-04-22T15:08:07.319Z (about 1 year ago)
- Topics: bluesky, bluesky-app, bluesky-client, qt, qtquick
- Language: C++
- Homepage:
- Size: 21.7 MB
- Stars: 29
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 羽衣 - Hagoromo -
(English follows Japanese.)
## 概要
マルチカラム対応の[Bluesky](https://blueskyweb.xyz/)クライアントです。

## 動作確認環境
- Windows 11 Profesional
- Ubuntu 22.04
- Mac 15.0.1(x86 on ARM)
## 使用ソフトウェア
- [Qt 6.8.1](https://www.qt.io/)
- [OpenSSL 3.4.0](http://www.openssl.org/)
- [cpp-httplib 0.18.1](https://github.com/yhirose/cpp-httplib)
- [zlib 1.3.1](https://github.com/madler/zlib)
- [Hugo 0.92.2](https://gohugo.io/)
## ダウンロード
ビルド済みの実行ファイルは[Releases](https://github.com/ioriayane/Hagoromo/releases)よりダウンロードしてください。
## インストール
アーカイブを解凍して任意のフォルダに保存してください。
## 使用方法
[ユーザーマニュアル](https://hagoromo.relog.tech/ja/)を参照してください。
## ビルド方法
### 共通
ビルドするプラットフォームのQt 5.15.2をインストールしてください。
Official site : [Qt](https://www.qt.io/)
### Windows
[Microsoft Visual Studio 2022](https://visualstudio.microsoft.com/)をインストールしてください(Community Edition可)。
改行コードをCRLFでチェックアウトしてください。
```cmd
REM checkout repo
>git clone git@github.com:ioriayane/Hagoromo.git
>cd Hagoromo
>git submodule update -i
REM copy and edit encryption seed
>copy lib\tools\encryption_seed_template.h lib\tools\encryption_seed.h
REM build Hagoromo
>.\scripts\build.bat path\to\Qt\6.8.1\msvc2022_64\bin
REM Execute
>deploy-hagoromo\hagoromo\Hagoromo.exe
```
### Ubuntu
build.shでビルドします。
```bash
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# setup dependent modules
$ sudo apt-get install zlib1g-dev
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh linux path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ ./deploy-hagoromo/hagoromo/Hagoromo.sh
```
### Mac
build.shでビルドします。
```bash
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh mac path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ open ./deploy-hagoromo/hagoromo/Hagoromo.app
```
## コントリビューション
変更を加えるときは`dev`からブランチして、`dev`にプルリクエストを提出してください。
また、下記の事項を実施してください。Github Actionsにてチェックしています。
### ソースコードの整形
[pre-commit](https://pre-commit.com/)を使用しています。
git hookで実行されるように公式サイトを確認してセットアップしてください。
セットアップ例
```bash
$ pip install pre-commit
$ pre-commit --version
pre-commit 3.7.1
$ cd path/to/this_repo
$ pre-commit install
pre-commit installed at .git/hooks/pre-commit
```
### 単体テスト
いづれかの環境で実行してクリアできることを確認してください。
Windows
```cmd
> .\scripts\unittest.bat path\to\Qt\6.8.1\msvc2022_64\bin
```
Ubuntu
```bash
$ ./scripts/unittest.sh linux path/to/Qt/6.8.1/gcc_64/bin
```
Mac
```bash
$ ./scripts/unittest.sh mac path/to/Qt/6.8.1/gcc_64/bin
```
---
## Overview
This is a multi-column [Bluesky](https://blueskyweb.xyz/) client.

## System Requirements
- Windows 11 Profesional
- Ubuntu 22.04
- Mac 15.0.1(x86 on ARM)
## Software used
- [Qt 6.8.1](https://www.qt.io/)
- [OpenSSL 3.4.0](http://www.openssl.org/)
- [cpp-httplib 0.18.1](https://github.com/yhirose/cpp-httplib)
- [zlib 1.3.1](https://github.com/madler/zlib)
- [Hugo 0.92.2](https://gohugo.io/)
## Download
Please download the pre-built executable from [Releases](https://github.com/ioriayane/Hagoromo/releases).
## Installation
Unzip the archive and save it in any folder.
## How to Use
Please refer to [the User's Manual](https://hagoromo.relog.tech/).
## How to Build
### Common
Install Qt 6.8.1 for the platform you want to build.
Official site : [Qt](https://www.qt.io/)
### Windows
Install [Microsoft Visual Studio 2022](https://visualstudio.microsoft.com/) (Community Edition is also available).
Check out the newline code in CRLF.
```cmd
REM checkout repo
>git clone git@github.com:ioriayane/Hagoromo.git
>cd Hangoromo
>git submodule update -i
REM copy and edit encryption seed
>copy lib\tools\encryption_seed_template.h lib\tools\encryption_seed.h
REM build Hagoromo
>.\scripts\build.bat path\to\Qt\6.8.1\msvc2022_64\bin
REM Execute
>deploy-hagoromo\hagoromo\Hagoromo.exe
```
### Ubuntu
It is built in build.sh.
```bash
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# setup dependent modules
$ sudo apt-get install zlib1g-dev
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh linux path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ ./deploy-hagoromo/hagoromo/Hagoromo.sh
```
### Mac
It is built in build.sh.
```bash
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh mac path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ open ./deploy-hagoromo/hagoromo/Hagoromo.app
```
## Contribution
If you want to make changes, please branch from `dev` and submit a pull request to `dev`.
Also, please do the following: Check in Github Actions.
### Code formatting
[pre-commit](https://pre-commit.com/) are used for source code formatting.
Please check the official site and set it up to run with git hook.
Setup Example
```bash
$ pip install pre-commit
$ pre-commit --version
pre-commit 3.7.1
$ cd path/to/this_repo
$ pre-commit install
pre-commit installed at .git/hooks/pre-commit
```
### Unit Tests
Please confirm that you can clear it by running it in one of the environments.
Windows
```cmd
> .\scripts\unittest.bat path\to\Qt\6.8.1\msvc2022_64\bin
```
Ubuntu
```bash
$ ./scripts/unittest.sh linux path/to/Qt/6.8.1/gcc_64/bin
```
Mac
```bash
$ ./scripts/unittest.sh mac path/to/Qt/6.8.1/gcc_64/bin
```