alex
df8d1adf15
- Replace all AdventureLog references with Voyage across ~102 files (7 case variants: AdventureLog, adventurelog, Adventurelog, ADVENTURELOG, AdventUrelog, AdventureLOG, adventure-log, adventure_log) - Rename brand, static, and documentation assets to use voyage naming - Rename install_adventurelog.sh → install_voyage.sh - Update README.md and voyage_overview.md to credit AdventureLog as the upstream project and Sean Morley as its original creator
2.9 KiB
Strava Integration
Strava is a popular platform for athletes to track their activities, share their workouts, and connect with other fitness enthusiasts. Integrating Strava with Voyage allows you to import your Strava activities directly into your vists, making it easier to keep track of your outdoor experiences.
To enable Strava integration in Voyage, you'll need to create a Strava API application. This application will provide you with the necessary client ID and client secret to authenticate with the Strava API.
Follow the steps below to generate your own Strava API credentials:
Strava API Application Setup
- Login to your Strava account at Strava.
- Go to the Strava API Applications page.
- Click on Create a New Application.
- Fill in the application details:
- Application Name: Voyage Strava Integration
- Website: Your Voyage instance URL (e.g.,
https://your-voyage-instance.com) - Authorization Callback Domain: Your Voyage instance domain (e.g.,
your-voyage-instance.com)
- Agree to the Strava API Terms
- Click Create to generate your application.
- After creation, you will see your Client ID and Client Secret. Keep these credentials safe as you will need them to configure Voyage.
Configuration in Voyage
- Once you have your Strava API credentials, you can configure Voyage to use them. Open your
.envfile in the root of your Voyage project and add the following lines:
STRAVA_CLIENT_ID=your_client_id_here
STRAVA_CLIENT_SECRET=your_client_secret_here
- After adding these lines, save the file and restart your Voyage server to apply the changes.
- Navigate to Voyage's settings page, click the integration tab, and find the Strava section.
- Click the Connect Account button. This will redirect you to Strava's authorization page.
- Log in to your Strava account and authorize Voyage to access your Strava data.
- After authorization, you will be redirected back to Voyage, and your Strava account will be linked.
Importing Strava Activities
The Strava integration appears on the visit create/edit part of the location edit popup. Once a visit is added, there will be a button on it to search for Strava activities. Clicking this button will search then you can import the activity into the visit. The imported activity will include details such as distance, duration, elevation gain, and more.
Note: Due to API limitations on Strava's side, when you import an activity, there will be a button that says Download GPX then you can download the GPX file of the activity and drop it into the input field of the visit. This manual action is necessary because Strava does not provide a direct way to import GPX files into Voyage.
Enjoy tracking your adventures with Strava and Voyage! If you encounter any issues or have questions about the integration, feel free to reach out to the Voyage community!