Help & Support

Welcome to AthletiQ, the intelligent fitness companion that helps you build, run, and track workouts with intelligent rep counting. This guide covers everything you need to get started and make the most of the app.

Getting Started

Creating Your Account

1. Open AthletiQ and follow the onboarding flow.
2. Enter your name, select your primary fitness goal, and set your fitness level.
3. Optionally note any injuries or limitations so workouts can be tailored to you.
4. Choose your training location and available equipment.
5. Sign up with Apple Sign-In or Email & Password.

Your profile information helps AthletiQ generate workouts suited to your body, experience, and goals.

Setting Up Your Equipment

1. From the Home tab, tap Edit Gear (or access it from the side menu).
2. Browse equipment by category: free weights, machines, bands, bodyweight, cardio, and more.
3. Tap items to select them. Selected equipment appears as pills at the top.
4. Your equipment list is used when generating workouts, so keep it accurate.

Core Features

Creating Workouts

Manually:

1. Go to the Workouts tab and tap +.
2. Add exercises one at a time. For each exercise, set:
   • Name (searches the exercise library automatically)
   • Type (rep-based or time-based)
   • Sets, reps or duration, rest periods
   • Weight (kg) or resistance band color
3. Group exercises into supersets or circuits for structured training.
4. Assign exercises to warm-up, main, or cool-down phases.

With Smart Coaching:

1. Tap Suggest Session on the Home tab (or the floating prompt bar in any workout view).
2. Describe what you want in plain language, e.g. "30-minute upper body with dumbbells" or "Quick HIIT no equipment".
3. AthletiQ generates a complete workout using your profile, equipment, and request.
4. Review, edit, save, or discard the suggestion.

Running a Workout

1. Open a workout and tap Play.
2. The app guides you through each exercise with set/rep counters and rest timers.
3. Flow mode runs exercises in fixed order. Flexible mode lets you pick what to do next.
4. After each set, log your actual reps and weight if they differ from the target.
5. Rest timers run automatically between sets and exercises. If you leave the app during rest, a floating bubble brings you back.
6. At the end, see your session summary with total duration, reps, and estimated calories.

Camera Rep Counting

1. During a workout, tap the camera icon to enable live rep counting.
2. Position your device so your full body is visible.
3. The app uses on-device pose detection (MediaPipe) to track your movement and count reps in real time.
4. Audio and haptic feedback confirm each counted rep.
5. All camera processing happens locally on your device. No images or video are stored or transmitted.

Tips for accurate counting:

• Ensure good lighting and a clear background.
• Place your device at a stable angle where your full body is in frame.
• Wear form-fitting clothing for better landmark detection.
• If counts are inconsistent, check the debug overlay in Settings to see detection confidence.

Training Programs

1. Go to the Plans tab and tap + to create a program.
2. Set a name, start date, and duration.
3. Schedule workouts by day of the week (e.g., Mon/Wed/Fri) or by interval (e.g., every 2 days).
4. Optionally enable progressive overload to automatically increase weight, volume, or reduce rest over time.
5. Start the program and the app tracks which workout is next, how many sessions you've completed, and your progression.

History & Analytics

Access from the Board tab or the Stats & History shortcut on Home.

History:

• See all completed workouts sorted by date.
• Tap any session for a detailed breakdown of exercises, sets, reps, and weights used.

Analytics:

• Filter by week, month, year, or all time.
• Muscle Balance radar chart shows how evenly you train across muscle groups.
• Time Distribution shows hours spent per muscle group.
• Summary stats: total workouts, total time, average duration, total calories.

Account & Settings

Editing Your Profile

From the side menu (swipe right on Home or tap your profile image), select Edit Profile:

• Update your name, username, age, height, weight.
• Change your fitness level or primary goal.
• Update injury information.
• Change your profile photo.

Coaching Configuration

In Settings, you can configure the model used for workout generation:

• Choose between available providers.
• Adjust generation parameters like temperature for more creative or conservative suggestions.

Rep Counting Settings

In Settings, fine-tune camera-based rep counting:

• Toggle between 2D and 3D coordinate systems.
• Adjust landmark visibility threshold (lower = more sensitive, higher = stricter).
• Enable/disable the debug overlay during workouts.

Signing Out

Go to Settings > Account > Sign Out. Your data remains synced in the cloud and will be available when you sign back in.

Troubleshooting

Rep counting is inaccurate or not working

• Make sure your full body is visible in the camera frame.
• Check lighting conditions. Low light reduces detection accuracy.
• In Settings, try lowering the landmark visibility threshold.
• Enable the debug overlay to see which joints are being detected and their confidence scores.
• Ensure the exercise has detection conditions configured (some exercises may not support camera counting).

Workout generation fails

• Check your internet connection.
• Verify your subscription is active.
• Try simplifying your prompt if the request is very complex.
• Restart the app and try again.

Workouts or data not syncing

• The app uses a local-first architecture. Data saves to your device immediately and syncs to the cloud in the background.
• Check your internet connection. The app will sync automatically when connectivity is restored.
• If issues persist, try signing out and back in.

App crashes or freezes during a workout

• Your session data is saved locally as you go. Reopen the app and your progress should be recoverable.
• Make sure your device has sufficient storage and your iOS version is up to date.

Camera permission not granted

• Go to your device's Settings > AthletiQ and enable Camera access.
• Restart the app after granting permission.

Contact Us

If you need further help or want to report an issue:

Email: support@athletiqlabs.org

We aim to respond within 48 hours. When reporting a bug, please include:

• Your device model and iOS version.
• A description of the issue and steps to reproduce it.
• Screenshots if applicable.

AthletiQ is developed by Flairr.