Skip to content

Commit a550069

Browse files
Robert-StackflowRobert-Stackflow
committed
Update README and version 3.1.1
1 parent b57a719 commit a550069

File tree

4 files changed

+240
-47
lines changed

4 files changed

+240
-47
lines changed

‎README.md‎

Lines changed: 122 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,127 @@
1-
## Introduction
1+
# CloudOTP
22

3-
This is an awesome two-factor authenticator based on Flutter for Android and Windows which supports cloud backup.
3+
**CloudOTP** is a modern, cross-platform two-factor authenticator built with Flutter.
44

5-
## Highlights
5+
It supports Android, Windows, and Linux, offering secure cloud backups, powerful token management, and a polished UI optimized for mobile, tablet, and desktop.
66

7-
- Reconstructed based on Flutter architecture, supports Android and Windows
8-
- Support TOTP, HOTP, MOTP, Steam, Yandex
9-
- Supports scanning QR code to add, identify pictures, and manually enter keys
10-
- Supports custom icons and categories, supports sorting and multiple token layouts(Simple, Compact, List, Spotlight)
11-
- Supports dark mode, multiple languages, and multiple themes
12-
- Supports local backup and automatic backup, supports WebDav, Onedrive, Dropbox, S3 storage and other cloud backup methods
13-
- Supports import/export of encrypted files and URI lists
14-
- Supports importing data from Aegis, andOTP, Bitwarden, EntAuth, FreeOTP+, Google Authenticator, 2FAS, TOTP Authenticator, Winauth
15-
- Supports database encryption and gesture password
7+
## 🚀 Highlights
168

17-
## Screenshots
9+
### 🌐 Cross-Platform Support
10+
11+
- Built with Flutter, runs seamlessly on **Android**, **Windows**, and **Linux**
12+
- UI fully optimized for **mobile**, **tablet**, and **desktop** environments
13+
14+
### 🔐 OTP Protocols
15+
16+
- Supports **TOTP**, **HOTP**, **MOTP**, **Steam**, and **Yandex** token algorithms
17+
18+
### ➕ Token Management
19+
20+
- Add tokens via **QR code scanning**, **image recognition**, or **manual entry**
21+
- Custom icons and categories
22+
- Flexible layout modes: **Simple**, **Compact**, **List**, and **Spotlight**
23+
- Supports **sorting** and **searching** for quick access
24+
25+
### 🌓 Themes & UI
26+
27+
- Fully responsive and adaptive UI for all device sizes
28+
- Supports **dark mode**, **multiple color themes**, and **multi-language UI**
29+
30+
### ☁️ Backup & Sync
31+
32+
- Supports **local** and **automatic cloud backup**
33+
- Integrates with **WebDAV**, **OneDrive**, **Dropbox**, **S3**, **Google Drive**, **Box**, **Huawei Cloud**, **Aliyun Drive**
34+
35+
### 🔁 Import/Export
36+
37+
- Export/import as **encrypted files** or **URI lists**
38+
- One-click import from: **Aegis**, **andOTP**, **Bitwarden**, **EntAuth**, **FreeOTP+**, **Google Authenticator**, **2FAS**, **TOTP Authenticator**, **WinAuth**
39+
40+
### 🛡️ Security
41+
42+
- Encrypted database storage
43+
- Supports **gesture password** for app access
44+
- Supports **biometric unlock**
45+
46+
## 📦 Installation
47+
48+
### 📱 Android
49+
50+
**Choose the correct ABI:**
51+
52+
| Variant | Description |
53+
| ------------- | ------------------------------------------------------------ |
54+
| `arm64-v8a` | For modern 64-bit Android devices (recommended for most users) |
55+
| `armeabi-v7a` | For most older 32-bit Android devices |
56+
| `x86_64` | For Android emulators or specific x86 tablets (not for regular devices) |
57+
| `universal` | Supports **all CPU architectures**, larger file size (recommended for most) |
58+
59+
If unsure, use the `universal` version. You can use tools like [Droid Info](https://play.google.com/store/apps/details?id=com.vndnguyen.deviceinfo) to check your device's architecture.
60+
61+
### 💻 Windows
62+
63+
| Variant | Description |
64+
| ------------------ | ------------------------------------------------------------ |
65+
| `Installer (.exe)` | Standard Windows installer with Start Menu integration and auto-updates |
66+
| `Portable (.zip)` | No installation required, can be run from any folder or USB stick |
67+
68+
> **Note:** Currently, only **x86_64 (64-bit)** Windows systems are supported.
69+
70+
### 🐧 Linux
71+
72+
#### 📦 Recommended: Flatpak
73+
74+
Install via [Flathub](https://flathub.org/apps/com.cloudchewie.cloudotp):
75+
76+
```bash
77+
flatpak install flathub com.cloudchewie.cloudotp
78+
```
79+
80+
Once installed, launch it via your app menu or by running:
81+
82+
```bash
83+
flatpak run com.cloudchewie.cloudotp
84+
```
85+
86+
#### 📥 Direct Downloads
87+
88+
Also available as `.deb` and `.tar.gz` packages from the [Releases](https://github.com/your-repo/releases) page.
89+
90+
| Architecture | Formats Available | Notes |
91+
| ------------ | ----------------- | ----------------------------- |
92+
| `x86_64` | `.deb`, `.tar.gz` | For most modern Linux systems |
93+
| `arm64` | `.deb`, `.tar.gz` | For devices like Raspberry Pi |
94+
95+
## 🧪 Development Setup
96+
97+
```bash
98+
git clone https://github.com/Robert-Stackflow/CloudOTP.git
99+
cd cloudotp
100+
flutter pub get
101+
flutter gen-l10n
102+
cd third-party/chewie
103+
flutter gen-l10n
104+
cd ../../
105+
flutter run -d windows # or android, linux
106+
````
107+
108+
## 📝 Roadmap
109+
110+
* [ ] iOS support (via macOS build)
111+
* [ ] Custom theme
112+
* [ ] Import custom icons
113+
114+
## 🤝 Contributing
115+
116+
Contributions, issues and feature requests are welcome!
117+
118+
Feel free to check the [issues page](https://github.com/Robert-Stackflow/CloudOTP/issues) or submit a PR.
119+
120+
## 📄 License
121+
122+
This project is licensed under the GPL-V3.0 License - see the [LICENSE](LICENSE) file for details.
123+
124+
## 📷 Screenshots
18125

19126
<img src="tools/art/mobile_1.png" alt="Mobile_1" style="zoom: 25%;" />
20127

@@ -24,4 +131,5 @@ This is an awesome two-factor authenticator based on Flutter for Android and Win
24131

25132
<img src="tools/art/mobile_3.png" alt="Mobile_3" style="zoom: 25%;" />
26133

27-
<img src="tools/art/desktop_2.png" alt="Desktop_2" style="zoom: 25%;" />
134+
<img src="tools/art/desktop_2.png" alt="Desktop_2" style="zoom: 25%;" />
135+

‎README_CN.md‎

Lines changed: 117 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,134 @@
1-
## 介绍
1+
# CloudOTP
22

3-
基于 Flutter 的双因素验证器，支持Android和Windows平台，支持云备份。
3+
**CloudOTP** 是一款现代、跨平台的双因素身份验证器，使用 Flutter 构建。
44

5-
## Highlights
5+
支持 Android、Windows 和 Linux，提供安全的云备份、强大的令牌管理功能。
66

7-
- 基于Flutter架构重构，支持Android和Windows
8-
- 支持TOTP、HOTP、MOTP、Steam、Yandex
9-
- 支持扫码添加、识别图片、手动输入密钥
10-
- 支持自定义图标和分类、支持排序和多种令牌布局（简洁、紧凑、列表、聚焦）
11-
- 支持深色模式、多种语言、多种主题
12-
- 支持本地备份和自动备份、支持WebDav、Onedrive、GoogleDrive、Dropbox、S3存储等多种云备份方式
13-
- 支持导入/导出加密文件、URI列表
14-
- 支持从Aegis、andOTP、Bitwarden、EntAuth、FreeOTP+、Google Authenticator、2FAS、TOTP Authenticator、Winauth导入数据
15-
- 支持数据库加密、手势密码
7+
## 🚀 功能亮点
168

17-
## Screenshots
9+
### 🌐 跨平台支持
1810

19-
<img src="tools/art/mobile_1.png" alt="Mobile_1" style="zoom: 25%;" />
11+
- 基于 Flutter 构建，可在 **Android**、**Windows** 和 **Linux** 上流畅运行
12+
- 界面为 **手机**、**平板** 和 **桌面** 环境精心优化
2013

21-
<img src="tools/art/desktop_1.png" alt="Desktop_1" style="zoom: 25%;" />
14+
### 🔐 OTP 协议支持
2215

23-
<img src="tools/art/mobile_2.png" alt="Mobile_2" style="zoom: 25%;" />
16+
- 支持 **TOTP**、**HOTP**、**MOTP**、**Steam** 和 **Yandex** 等令牌算法
2417

25-
<img src="tools/art/mobile_3.png" alt="Mobile_3" style="zoom: 25%;" />
18+
### ➕ 令牌管理
19+
20+
- 通过 **二维码扫描**、**图片识别** 或 **手动输入** 添加令牌
21+
- 支持自定义图标与分类
22+
- 多种布局模式：**简洁**、**紧凑**、**列表**、**聚焦**
23+
- 支持 **排序** 和 **搜索**
24+
25+
### 🌓 主题与界面
26+
27+
- 完全响应式和自适应 UI，适配所有设备尺寸
28+
- 支持 **深色模式**、**多种配色主题** 与 **多语言界面**
29+
30+
### ☁️ 云备份与同步
31+
32+
- 支持 **本地备份** 与 **自动云备份**
33+
- 集成多种云服务：**WebDAV**、**OneDrive**、**Dropbox**、**S3**、**Google Drive**、**Box**、**华为云**、**阿里云盘**
34+
35+
### 🔁 导入与导出
36+
37+
- 支持导出/导入为 **加密文件** 或 **URI 列表**
38+
- 一键导入支持：**Aegis**、**andOTP**、**Bitwarden**、**EntAuth**、**FreeOTP+**、**Google Authenticator**、**2FAS**、**TOTP Authenticator**、**WinAuth**
39+
40+
### 🛡️ 安全性
41+
42+
- 本地数据库加密存储
43+
- 支持 **手势密码** 解锁
44+
- 支持 **生物识别** 解锁
45+
46+
## 📦 安装指南
47+
48+
### 📱 Android
49+
50+
**请选择合适的 ABI 架构版本：**
51+
52+
| 版本 | 说明 |
53+
| ------------- | ---------------------------------------------------------- |
54+
| `arm64-v8a` | 适用于大多数现代 64 位 Android 设备（推荐） |
55+
| `armeabi-v7a` | 适用于多数旧款 32 位 Android 设备 |
56+
| `x86_64` | 适用于 Android 模拟器或部分 x86 平板（不推荐普通用户使用） |
57+
| `universal` | 支持所有 CPU 架构，文件体积较大（推荐大多数用户使用） |
58+
59+
如不确定设备架构，建议下载 `universal` 版本。可使用 [Droid Info](https://play.google.com/store/apps/details?id=com.vndnguyen.deviceinfo) 等工具查询设备信息
60+
61+
### 💻 Windows
62+
63+
| 版本 | 说明 |
64+
| ------------------ | ----------------------------------------- |
65+
| `Installer (.exe)` | 标准安装程序，支持自动更新 |
66+
| `Portable (.zip)` | 免安装版，可直接运行于任意文件夹或 U 盘中 |
2667

27-
<img src="tools/art/desktop_2.png" alt="Desktop_2" style="zoom: 25%;" />
68+
> **注意：** 当前仅支持 **x86_64（64 位）** 的 Windows 系统。
2869
29-
## TODOs
70+
### 🐧 Linux
3071

31-
- 桌面端支持
72+
#### 📦 推荐方式：Flatpak 安装
3273

33-
- 多窗口支持
34-
- 快捷键功能优化
74+
可通过 [Flathub](https://flathub.org/apps/com.cloudchewie.cloudotp) 安装：
3575

36-
- 小功能/小Bug
76+
```bash
77+
flatpak install flathub com.cloudchewie.cloudotp
78+
```
3779

38-
- 开机自启动后最小化到托盘
80+
安装后可通过应用菜单启动，或运行：
3981

40-
- 托盘锁定功能——未设置/已禁用
41-
- 修改语言时Tabbar全部未随之更改
82+
```bash
83+
flatpak run com.cloudchewie.cloudotp
84+
```
4285

43-
- 次优先级
86+
#### 📥 直接下载
87+
88+
也可通过 [Releases](https://github.com/your-repo/releases) 页面下载 `.deb` 与 `.tar.gz` 包。
89+
90+
| 架构 | 提供格式 | 说明 |
91+
| -------- | ----------------- | --------------------------------- |
92+
| `x86_64` | `.deb`, `.tar.gz` | 适用于大多数现代 Linux 系统 |
93+
| `arm64` | `.deb`, `.tar.gz` | 适用于 Raspberry Pi 等 ARM64 设备 |
94+
95+
## 🧪 开发环境配置
96+
97+
```bash
98+
git clone https://github.com/Robert-Stackflow/CloudOTP.git
99+
cd cloudotp
100+
flutter pub get
101+
flutter gen-l10n
102+
cd third-party/chewie
103+
flutter gen-l10n
104+
cd ../../
105+
flutter run -d windows # 也可指定 android、linux 等平台
106+
```
107+
108+
## 📝 开发计划
109+
110+
* [ ] iOS 支持（通过 macOS 构建）
111+
* [ ] 自定义主题
112+
* [ ] 导入自定义图标
113+
114+
## 🤝 欢迎贡献
115+
116+
欢迎提交 PR、反馈问题或提出功能建议！
117+
118+
你可以浏览 [issues 页面](https://github.com/Robert-Stackflow/CloudOTP/issues)，或者直接提交代码贡献
119+
120+
## 📄 许可证
121+
122+
本项目遵循 GPL-V3.0 协议，详情请查阅 [LICENSE](https://chatgpt.com/c/LICENSE) 文件
123+
124+
## 📷 截图
125+
126+
<img src="tools/art/mobile_1.png" alt="Mobile_1" style="zoom: 25%;" />
127+
128+
<img src="tools/art/desktop_1.png" alt="Desktop_1" style="zoom: 25%;" />
129+
130+
<img src="tools/art/mobile_2.png" alt="Mobile_2" style="zoom: 25%;" />
131+
132+
<img src="tools/art/mobile_3.png" alt="Mobile_3" style="zoom: 25%;" />
44133

45-
- 自定义主题
46-
- 导入字体文件
47-
- icon逻辑修改——同一个icon多种匹配规则
134+
<img src="tools/art/desktop_2.png" alt="Desktop_2" style="zoom: 25%;" />

‎pubspec.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: cloudotp
2-
version: 3.1.0+310
2+
version: 3.1.1+311
33
description: An awesome two-factor authenticator which supports cloud storage and multiple platforms.
44
publish_to: none
55

‎third-party/chewie/lib/src/Utils/General/responsive_util.dart‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -173,8 +173,6 @@ class ResponsiveUtil {
173173
MediaQuery.sizeOf(chewieProvider.rootContext).shortestSide;
174174
bool sizeCondition =
175175
longestSide >= longestThreshold && shortestSide >= shortestThreshold;
176-
ILogger.debug(
177-
"isTablet: longestSide: $longestSide, shortestSide: $shortestSide, sizeCondition: $sizeCondition");
178176
return !kIsWeb && (Platform.isIOS || Platform.isAndroid) && sizeCondition;
179177
}
180178

0 commit comments

Comments
 (0)