GymManager | Gym Membership Management System with POS and QR Access Control

GymManager | Gym Membership Management System with POS and QR Access Control

GymManager is a complete, ready-to-use management system for gyms, fitness studios, boxing clubs and sport centers. Manage memberships and payments, sell drinks and supplements at the front desk, control your stock and close your cash register every day — all from one clean, modern interface.

It runs locally on any Windows, Linux or Mac computer (one double-click to start) or on your own server. No monthly fees, no cloud subscription: your data stays with you in a single SQLite file.

Main Features

• Members & subscriptions – member code, phone, sports (multiple), coach, plan (daily, monthly, quarterly, semi-annual, yearly), insurance, discount, partial payments and live remaining balance
• Individual & corporate memberships with partner company tracking
• Payments follow-up – record new payments on existing subscriptions, see unpaid balances and inactive members
• QR member cards – a printable card with a unique QR code is generated for every new member
• QR access control – scan the card with a webcam or a USB scanner: green “Access granted” or red “Access denied” (expired, unpaid balance, inactive), with sound and daily entry log
• Payment methods – Cash, Card and Mobile on every subscription and payment, with a daily split by method
• Printable invoices – subscription invoice, renewal invoice and payment receipt with PAID / BALANCE DUE stamp
• Subscription renewal – automatic period dates (daily, monthly, quarterly, semi-annual, yearly), insurance charged for each new period
• Touch-friendly POS – category buttons, product search, cart, walk-in or member checkout
• Stock management – product code, category, unit, price, image upload, minimum quantity and low-stock alerts
• Stock movements – automatic deduction at each checkout, manual stock in/out with reason, full history
• Expenses – rent, salaries, electricity, maintenance, stock purchases and more
• Daily cash report – products sold + subscriptions + new payments − expenses = net cash, with cash carry-over to the next day
• Advanced report page – filter by client, product, status, membership type, company, phone, date, month and year
• Excel & CSV exports – full workbook, ZIP of CSV files, or individual tables
• Two roles – Admin (full control) and User (front-desk staff, no delete / no reports)
• Secure – random admin password for every installation, password change required at first login, CSRF protection on every form, POST-only deletions, hashed passwords, server-side validation of all quantities and amounts, admin-only sensitive actions
• All amounts in US dollars (USD), configurable app name
• Works offline – Bootstrap, icons and fonts are bundled, no CDN required
• Modern dark glassmorphism design, optimized for desktop and POS screens
• Optional demo data script and admin password reset tool

Requirements

• Python 3.9 or newer
• Local: Windows 10/11, Linux or macOS
• Online: cPanel hosting with “Setup Python App”, a Linux VPS, or Windows Server / IIS
• Desktop / laptop / POS screen (min. width 1280 px recommended)
• Packages installed automatically: Flask, openpyxl, waitress, qrcode
• Optional: webcam or USB/Bluetooth QR scanner for access control

Installation

On your computer (local)

• Windows: install Python, extract the package, double-click start_windows.bat, open http://localhost:5000
• Linux / macOS: install Python 3, extract the package, run ./start_linux_mac.sh, open http://localhost:5000

On a web host / server

• cPanel (Linux shared hosting): “Setup Python App” – passenger_wsgi.py included, step-by-step guide
• Linux VPS: Waitress or Gunicorn + Nginx, ready-to-copy systemd and Nginx examples
• Windows Server / IIS / Plesk Windows: web.config template for HttpPlatformHandler included

A complete offline HTML documentation is included (installation, network/server deployment, configuration, user guide, backup, troubleshooting).

What’s Included

• Full Python / Flask source code
• HTML templates (Jinja2 + Bootstrap 5), printable invoices and member cards
• One-click start scripts for Windows, Linux and macOS
• Hosting files: passenger_wsgi.py (cPanel), web.config template (IIS / Windows), wsgi.py (VPS)
• Production entry point (Waitress / Gunicorn) + Nginx and systemd examples
• Documentation

Credits

• Flask (BSD-3), openpyxl (MIT), Waitress (ZPL 2.1), qrcode (BSD), html5-qrcode (Apache 2.0)
• Bootstrap 5 (MIT), Font Awesome Free 6 (CC BY 4.0 / OFL / MIT)
• Poppins font (SIL OFL 1.1)
• Names and figures shown in the screenshots are fictitious demo data.

Changelog

v1.0.0 – October 2026
- Initial release

Support

Questions or problems? Contact us through the Support tab.