Usage¶

The CLI way¶

You can use gols with your favorite command line terminal, that’s fine, just run gols –help and see what commands, switches you need to enter !

Usage: gols [OPTIONS] COMMAND [ARGS]...

Options:
  --debug / --no_debug  Set to true to see debug logs on top of info
  --help                Show this message and exit.

Commands:
  upload  uploads .fit files to your garmin connect account

The upload command needs in particular your username and password account. You can pass them with the -u and -p switches respectively, however it’s recommended you use the environment variables. So either you do

export GARMINCONNECT_USERNAME=user GARMINCONNECT_PASSWORD=password gols --debug upload blabblablabla

Either you add those variables in your favorite .zshrc, if you just have a .bashrc go get zsh and oh-my-zsh !

The automatic way¶

To use gols in a more user friendly manner, you’ll need 3 things, this assumes your distribution uses systemd, should it not be the case you can adapt using udev rules ! The installation is a little-bit involved but worth the effort, I now just plugs my watch and bam, it’s uploaded !

Add your Garmin device to your /etc/fstab, mine for instance

#garmin fenix 2
UUID=489A-9E97 /media/fenix2 vfat auto,nofail,rw,user,uid=1000,gid=1000 0 2

Then endpoint /media/fenix2 is created by the user who will upload its activities and you’ll have to run sudo blkid to get the device UUID. Issue a systemd daemon-reload so that you get the mount name systemd will assign to your new entry.

Create a systemd user unit with systemctl –user edit gols.service –force.

What is important in that file is the media-fenix2.mount, adapt yours with what systemd came up after step 1.

[Unit]
Description=gols a little less now
Requires=media-fenix2.mount
After=media-fenix2.mount
[Service]
Environment="GARMINCONNECT_USERNAME=user"
Environment="GARMINCONNECT_PASSWORD=password"
ExecStart=gols --debug upload /media/fenix2/Garmin/Activity -m -c /home/user/.config/gols/fit
[Install]
WantedBy=media-fenix2.mount