openGym

1. openGym là gì?

openGym là ứng dụng ghi lại buổi tập gym và cân nặng của bạn, miễn phí và mã nguồn mở. Bạn lên lịch tập theo từng ngày trong tuần, mở buổi tập là app điền sẵn mức tạ lần trước, có đồng hồ nghỉ giữa các hiệp, và có biểu đồ để xem mình tiến bộ ra sao. Thư viện có 1.324 bài tập kèm hình minh họa chuyển động, theo thông tin trong README của dự án.

Điểm khác với các app tập luyện thông thường: theo dự án, dữ liệu nằm trên máy của bạn, không cần tạo tài khoản trên máy chủ của người khác, không gói trả phí, không quảng cáo, không gửi dữ liệu theo dõi. Nó thay cho những app ghi buổi tập thường đòi đăng ký trả tiền mới dùng đầy đủ.

Lưu ý về ngôn ngữ: app có 17 ngôn ngữ, nhưng danh sách bản dịch trong mã nguồn không có tiếng Việt. Bạn sẽ dùng giao diện tiếng Anh (hoặc một ngôn ngữ khác trong danh sách). Tên bài tập là tiếng Anh nên lần đầu có thể cần tra nghĩa.

Hợp với bạn nếu:

• Bạn tập gym và muốn một cuốn sổ tập điện tử không bắt đăng ký, không trả tiền.
• Bạn dùng điện thoại Android: có file cài sẵn, dùng ngay, không cần máy chủ.
• Bạn muốn thử trước khi cài: có bản dùng thử ngay trong trình duyệt.

Chưa hợp nếu:

• Bạn dùng iPhone và muốn cài như app thường: Apple không cho cài app ngoài App Store, và dự án chưa có bản trên App Store (có trong kế hoạch). Trên iPhone phải tự dựng máy chủ rồi thêm vào màn hình chính, khá phức tạp.
• Bạn cần app tiếng Việt hoàn toàn.

2. Cần chuẩn bị gì?

Có ba cách dùng, chọn một:

Cách	Cần gì	Dành cho
A. Dùng thử trên trình duyệt	Máy tính hoặc điện thoại có trình duyệt và mạng	Muốn xem trước
B. Cài app Android	Điện thoại Android	Dùng thật, dễ nhất
C. Tự dựng máy chủ riêng	Máy tính cài Docker, biết gõ vài dòng lệnh	Muốn đồng bộ nhiều thiết bị, nhiều người dùng

Không cần tài khoản, không cần khóa API, không mất tiền. File cài Android nặng khoảng 16 MB (bản 1.3.9). Cách C cần thêm khoảng 140 MB để tải hình và ảnh động bài tập ở lần chạy đầu.

Chỉ cách C cần cài Docker (phần mềm giúp chạy ứng dụng trong "hộp" riêng, không lẫn vào máy). Tải ở trang chính thức: https://docs.docker.com/get-docker/

3. Cài đặt từng bước

Cách A: Dùng thử trên trình duyệt (không cài gì)

1. Mở https://opengym.duarte-santos.ch/demo/
2. Bạn sẽ thấy app chạy ngay với dữ liệu mẫu. Bấm thử một buổi tập.

Bản này chạy hoàn toàn trong trình duyệt, chỉ để xem thử.

Cách B: Cài app Android (khuyên dùng)

openGym không có trên Google Play (dự án chủ động như vậy), nên bạn tải file cài đặt (đuôi .apk) trực tiếp.

Bước 1: Tải file .apk. Trên điện thoại, mở https://github.com/DuarteSantos8/openGym/releases/latest, kéo xuống mục Assets và bấm file có tên dạng openGym-1.3.9.apk (số phiên bản có thể mới hơn). Bên cạnh có file .sha256 để kiểm tra file không bị sửa, bạn có thể bỏ qua.

Bước 2: Cho phép cài. Mở file vừa tải. Android sẽ hỏi có cho phép cài app từ nguồn này không. Bấm cho phép (tên menu khác nhau tùy hãng máy) rồi bấm Cài đặt.

Bước 3: Mở app. Lần đầu app hỏi bạn muốn dùng thế nào. Chọn dùng riêng trên điện thoại (không cần máy chủ, không cần tài khoản); dữ liệu nằm trong bộ nhớ riêng của app.

Làm đúng thì bạn thấy màn hình chính của app với buổi tập hôm nay.

Cách C: Tự dựng máy chủ trên máy tính (nâng cao)

Dành cho người muốn đồng bộ nhiều thiết bị. Cần Docker đã cài và đang chạy. Mở Terminal (macOS/Linux) hoặc PowerShell (Windows) rồi gõ lần lượt:

git clone https://github.com/DuarteSantos8/openGym
cd openGym
cp .env.example .env
docker compose pull
docker compose up -d

Lệnh git clone cần cài Git (công cụ tải mã nguồn) từ https://git-scm.com/downloads. Trong Windows PowerShell lệnh cp chạy được; nếu báo lỗi, hãy sao chép file .env.example thành .env bằng File Explorer.

Lần chạy đầu sẽ tải khoảng 140 MB hình bài tập, vui lòng đợi. Sau đó mở http://localhost:8080 và bấm Create profile (tạo hồ sơ). Thấy màn hình chính là xong.

Lưu ý: muốn dùng từ điện thoại với đăng nhập bằng vân tay/Face ID (passkey), bạn cần địa chỉ HTTPS với tên miền riêng. Việc này nằm ngoài phạm vi hướng dẫn này, xem https://github.com/DuarteSantos8/openGym/blob/main/docs/SELF_HOSTING.md

4. Dùng lần đầu

1. Mở app, tạo lịch tập: chọn một trong bốn kế hoạch mẫu (Push/Pull/Legs, Upper/Lower, Full Body, 5×5) hoặc tự tạo.
2. Đến ngày tập, buổi tập của hôm nay tự hiện lên. Mức tạ lần trước được điền sẵn.
3. Sau mỗi hiệp, ghi số lần và mức tạ; đồng hồ nghỉ chạy giữa các hiệp.
4. Mở mục thống kê để xem biểu đồ và kỷ lục cá nhân.

Nếu bạn đã dùng FitNotes, Strong hoặc Hevy, app có chức năng nhập dữ liệu cũ.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Android chặn, không cho cài file .apk	Máy chưa cho phép cài từ nguồn ngoài Google Play	Làm theo hộp thoại, bật cho phép cho trình duyệt hoặc trình quản lý file mình đang dùng
Báo "không cài được" hoặc app không mở	File tải dở hoặc máy quá cũ	Tải lại file từ trang Releases chính thức rồi thử lại
docker: command not found hoặc không kết nối được Docker	Docker chưa cài hoặc chưa chạy	Cài Docker, mở Docker Desktop, đợi nó báo đang chạy rồi chạy lại lệnh
http://localhost:8080 không mở được	Container chưa chạy xong, hoặc cổng 8080 bị app khác chiếm	Gõ docker compose ps để xem trạng thái; đổi WEB_PORT trong file .env sang số khác rồi chạy lại docker compose up -d
Đăng nhập passkey không hiện trên điện thoại	Passkey chỉ chạy trên HTTPS hoặc localhost	Dùng app Android bản riêng, hoặc xem hướng dẫn dựng HTTPS của dự án

6. Gỡ cài đặt và cập nhật

• App Android: gỡ như mọi app khác. Dữ liệu trong app sẽ mất, nên vào Settings → Data xuất file sao lưu trước. Theo dự án, app tự kiểm tra bản cập nhật.
• Máy chủ Docker: dừng bằng docker compose down. Dữ liệu nằm ở thư mục data cạnh file docker-compose.yml; sao lưu thư mục này là đủ. Muốn cập nhật, xem mục Updating trong hướng dẫn tự dựng máy chủ của dự án.

7. Câu hỏi hay gặp

Có mất tiền không? Không. Theo FAQ của dự án: không đăng ký trả phí, không gói trả tiền, không quảng cáo. Có nút ủng hộ tự nguyện.

Dữ liệu có bị gửi đi đâu không? Theo FAQ của dự án, bản mặc định không gửi dữ liệu theo dõi. Trong app Android, dữ liệu nằm trong bộ nhớ riêng của app. Chỉ tính năng "AI coach" tùy chọn (mặc định tắt) mới gửi dữ liệu tập cho nhà cung cấp AI do bạn tự chọn.

Có cần mạng không? Cần để tải file cài lần đầu; dự án nói app hoạt động được khi offline.

Có bản cho iPhone không? Không có trên App Store. Xem phần "Chưa hợp nếu" ở mục 1.

Dự án có dùng AI để viết không? Theo FAQ của dự án, mã nguồn được phát triển có sự hỗ trợ của Claude Code, và người duy trì dự án xem xét, kiểm thử từng bản phát hành.