/obsidian-strava-connector

Primary LanguageTypeScript

Strava Connector for Obsidian

The Strava Connector for Obsidian is a plugin designed to seamlessly integrate Strava activities and metrics into your Obsidian notes. This plugin is perfect for athletes, fitness enthusiasts, and anyone interested in tracking their physical activities alongside their daily notes, journal entries, or project management tasks within Obsidian.

Features

  • Activity Sync: Automatically syncs your Strava activities into your Obsidian vault, allowing you to view and manage your workouts, runs, bike rides, and more directly from Obsidian.
  • Metrics Visualization: Displays key metrics from your Strava activities, such as distance, pace, elevation gain, and heart rate, in a visually appealing format within your notes.
  • Customizable Templates: Use or customize templates for different types of activities to automatically format your synced data in a way that best suits your note-taking style.
  • Manual Entry Support: For activities not recorded on Strava, the plugin allows manual entry of activities directly into Obsidian, ensuring you can track all your physical efforts in one place.

Technologies Used

  • Obsidian API: Utilizes the Obsidian plugin API for seamless integration within the Obsidian ecosystem, enabling the plugin to interact with your notes and vault.
  • Strava API: Leverages the Strava API to fetch activity data, ensuring accurate and up-to-date information is always available.
  • JavaScript: The core functionality of the plugin is developed in JavaScript, making it compatible with the Obsidian plugin architecture.
  • CSS: Custom CSS is used for styling the activity data and metrics within your notes, ensuring a pleasant and customizable user experience.
  • React Integration: Incorporates React to enhance the UI components within Obsidian, providing a more dynamic and responsive user experience.
  • TanStack Query: Utilizes TanStack Query for efficient data fetching, caching, and synchronization of Strava activities, ensuring a smooth and fast user experience.

Getting Started

To get started with the Strava Connector for Obsidian, follow these steps:

  1. Ensure you have Obsidian installed and that you have an active Strava account.
  2. Download the Strava Connector plugin from the Obsidian community plugins list.
  3. Install the plugin in Obsidian and configure it by connecting it to your Strava account.
  4. Start syncing your activities and enjoy viewing your Strava metrics directly within your Obsidian notes!

For detailed installation instructions and configuration options, please refer to the official documentation.