Workout AI Tracker

Advanced workout tracking plugin for Obsidian with AI-powered analysis using Claude API.

✨ Features

📝 Workout Tracking

• ✅ Template-based workouts - Select from 5 default templates or create custom ones
• ✅ Quick workout entry with modal interface
• ✅ Track weight, reps, RPE, heart rate for each set
• ✅ Warmup/cooldown cardio activities (elliptical, rowing, etc.)
• ✅ Automatic markdown file generation with Obsidian Base properties
• ✅ Organized in customizable folder structure
• ✅ Progress tracking within workout (exercise X of Y)

⏱️ Built-in Tools

• ✅ Rest timer with countdown and notifications
• ✅ Quick add exercise to today's workout
• ✅ Progressive volume and set tracking
• ✅ Duration tracking

🤖 AI-Powered Analysis

• ✅ Claude API integration for intelligent workout analysis
• ✅ Progress tracking (weights, reps, volume)
• ✅ Program recommendations
• ✅ Recovery analysis
• ✅ Imbalance detection
• ✅ Personalized training advice

📊 Data Organization

• ✅ Uses Obsidian Base (properties in frontmatter)
• ✅ Markdown files for full-text search
• ✅ Git-friendly version control
• ✅ No external dependencies

Below are some screenshots of the app in action:

New Workout Selection

Template Management

Workout Session

🚀 Installation

Manual Installation

1. Download the latest release
2. Extract files to .obsidian/plugins/workout-ai-tracker/ in your vault
3. Reload Obsidian
4. Enable "Workout AI Tracker" in Settings → Community Plugins

From Source

git clone https://github.com/yourusername/obsidian-workout-ai
cd obsidian-workout-ai
npm install
npm run build

Copy main.js, manifest.json, and styles.css to your vault's plugins folder.

⚙️ Setup

1. Get Claude API Key

1. Go to https://console.anthropic.com/
2. Create an account or sign in
3. Generate an API key
4. Copy the key (starts with sk-ant-...)

2. Configure Plugin

1. Open Obsidian Settings
2. Go to Workout AI Tracker
3. Paste your Claude API key
4. Set your workouts folder (default: Workouts)
5. Configure default rest time (default: 90 seconds)

📖 Usage

Starting a Workout

Method 1: Ribbon Icon

• Click the 🏋️ icon in the left ribbon
• Select a template from the list (Day 1, Day 2, Day 3, Quick Upper, Quick Lower)
• Click "Start" to begin the workout with pre-configured exercises
• Or click "Create Empty Workout" for a custom workout

Method 2: Command Palette

• Press Cmd/Ctrl + P
• Type "Start new workout"
• Press Enter
• Select your template

Method 3: Hotkey (configure in settings)

• Set custom hotkey for "Start new workout"

Using Workout Templates

The plugin comes with 5 default templates based on your optimized training program:

1. Day 1 - Back and Biceps (60 min, 7 exercises)

   • Back and biceps focused workout
   • Includes Bent Over Row, Lat Pulldown, Seated Row, Face Pull, Hammer Curl, Cable Curl, Back Extension

2. Day 2 - Chest, Shoulders and Triceps (65 min, 8 exercises)

   • Chest, shoulders, and triceps
   • Includes Bench Press, Incline Press, Overhead Press, Lateral Raise, Reverse Fly, Tricep Pushdown

3. Day 3 - Legs and Abs (70 min, 9 exercises)

   • Legs and abs
   • Includes Goblet Squat, Leg Press, Romanian Deadlift, Bulgarian Split Squat, Leg Curl, Calf Raise, Abs exercises

4. Quick Upper Body (30 min, 4 exercises)

   • Fast upper body workout
   • Push-ups, Pull-ups, Overhead Press, Dumbbell Row

5. Quick Lower Body (30 min, 4 exercises)

   • Fast lower body workout
   • Goblet Squat, Lunges, Romanian Deadlift, Calf Raises

Managing Templates:

• Press Cmd/Ctrl + P and type "Manage workout templates"
• ✏️ Edit any template (default or custom):
  • Default templates: Creates a new custom copy when saved
  • Custom templates: Updates the existing template
• ➕ Create new templates from scratch with the "+" button
• 📋 Duplicate templates to create variations
• 🗑️ Delete custom templates (default templates are protected)
• Custom templates are saved in plugin data.json (persistent, synced with vault)

Template Editor Features:

• Edit template name, description, and tags
• Add/remove/reorder exercises within the template
• Configure sets, reps range (min-max), and rest time for each exercise
• Set target weights as suggestions for exercises
• Add exercise notes (technique tips, progression advice)
• Set estimated workout duration
• Enable/disable warmup and cooldown (with duration)
• Save validates that name and at least one exercise are present

Tracking Exercises

When using a template, the plugin guides you through each exercise:

1. Current Exercise Info - Shows exercise name, target sets/reps, rest time, and notes
2. Set Counter - Displays which set you're on (e.g., "Set 2 of 3")
3. Input Weight and Reps - Enter the weight (kg) and repetitions completed
4. Optional Fields - Add RPE (1-10) and heart rate if desired
5. Add Set - Click to record the set
6. Progress Automatically - Plugin moves to next set or exercise
7. Skip Exercise - Option to skip if needed
8. View Completed - See summary of all completed sets
9. Finish Workout - Save to markdown file when done

Template-Free Workouts:

• Choose "Create Empty Workout" for custom workouts
• Manually enter each exercise name as you go
• Add sets one at a time with full flexibility

Using Rest Timer

• After completing a set, press Cmd/Ctrl + P
• Type "Start rest timer"
• Timer countdown begins
• Skip anytime or wait for completion

AI Analysis

Analyze Recent Workouts:

1. Open any note
2. Press Cmd/Ctrl + P
3. Type "Analyze workouts with AI"
4. Wait for AI analysis
5. Analysis inserted into current note

What AI Analyzes:

• 📈 Progress trends (weight/reps/volume)
• 💡 Program recommendations
• 😴 Recovery assessment
• ⚖️ Muscle group imbalances
• 🎯 Specific next-workout advice

📁 File Format

Generated Workout File

---
date: 2025-11-08
program: Day 1 - Back and Biceps
duration: 45
totalSets: 18
totalVolume: 2450
type: workout
---

# Day 1 - Back and Biceps

📅 2025-11-08 | ⏱️ 45 min | 💪 18 sets | 📊 2450 kg volume

## 🏃 Warmup

- **Type:** Elliptical
- **Duration:** 10 min
- **Resistance:** 7
- **Incline:** 8
- **Average HR:** 118 bpm

## 💪 Exercises

### Bent Over Row (Barbell)

| Set | Weight (kg) | Reps | RPE | HR | Rest (sec) |
| --- | ----------- | ---- | --- | --- | ---------- |
| 1   | 20          | 12   | 7   | 135 | 90         |
| 2   | 20          | 12   | 8   | 138 | 90         |
| 3   | 20          | 12   | 9   | 142 | 90         |

### Lat Pulldown (Machine)

| Set | Weight (kg) | Reps | RPE | HR | Rest (sec) |
| --- | ----------- | ---- | --- | --- | ---------- |
| 1   | 40          | 12   | 7   | 130 | 90         |
| 2   | 40          | 12   | 8   | 133 | 90         |
| 3   | 40          | 11   | 9   | 137 | 90         |

## 🏃 Cooldown

- **Type:** Elliptical
- **Duration:** 10 min
- **Resistance:** 7
- **Incline:** 8
- **Average HR:** 115 bpm

## 📝 Notes

Great workout! Feeling progress on rows.

Obsidian Base Properties

Properties automatically added to frontmatter:

• date - Workout date (YYYY-MM-DD)
• program - Program name
• duration - Total minutes
• totalSets - Number of sets completed
• totalVolume - Total kg lifted (weight × reps)
• type - Always "workout" for filtering

Querying with Dataview

TABLE duration, totalSets, totalVolume
FROM "Workouts"
WHERE type = "workout"
SORT date DESC
LIMIT 10

TABLE WITHOUT ID
  date as "Date",
  duration as "Duration (min)",
  totalVolume as "Volume (kg)"
FROM "Workouts"
WHERE program = "Day 1 - Back and Biceps"
SORT date DESC

🎨 Customization

Custom CSS

Add to your vault's .obsidian/snippets/workout-custom.css:

/* Custom workout card styling */
.exercise-item {
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  color: white;
}

/* Timer styling */
.timer-display {
  color: #ff6b6b;
  font-size: 96px;
}

🔧 Advanced Usage

Templates

Create a template in Templates/Workout Template.md:

---
date: { { date } }
program: { { title } }
type: workout
---

# {{title}}

## Warmup

- [ ] 10 min elliptical

## Exercises

- [ ] Exercise 1
- [ ] Exercise 2

## Cooldown

- [ ] 10 min elliptical

Dataview Dashboards

Create Workouts Dashboard.md:

# 🏋️ Workout Dashboard

## This Week

```dataview
LIST duration + " min"
FROM "Workouts"
WHERE type = "workout" AND date >= date(today) - dur(7 days)
SORT date DESC
```

## Total Volume by Program

```dataview
TABLE WITHOUT ID
  program as "Program",
  sum(totalVolume) as "Total Volume (kg)",
  count(rows) as "Sessions"
FROM "Workouts"
WHERE type = "workout"
GROUP BY program
```

## Recent PRs

```dataview
TABLE date, program, totalVolume
FROM "Workouts"
WHERE type = "workout"
SORT totalVolume DESC
LIMIT 5
```

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

• Obsidian team for amazing plugin API
• Anthropic for Claude API
• Community plugin developers for inspiration

🐛 Bug Reports

Report issues at: https://github.com/yourusername/obsidian-workout-ai/issues

📮 Support

• GitHub Discussions: Ask questions and share ideas
• Email: [email protected]

Made with 💪 for the Obsidian community