diff options
author | cos <cos> | 2022-06-12 08:31:20 +0200 |
---|---|---|
committer | cos <cos> | 2022-06-12 17:16:26 +0200 |
commit | 2b399b43ba88713eef4e2983f434025d8c6c9e7b (patch) | |
tree | b5c35512a1ef9db18c7d2a668fde337fc7cf4d3b /README.md | |
download | lctns-cli-2b399b43ba88713eef4e2983f434025d8c6c9e7b.zip |
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..998868b --- /dev/null +++ b/README.md @@ -0,0 +1,55 @@ +lctns-edit +========== +A quickly prototyped tool to edit name, latitude and longitude in LCTNS.FIT as +found on Garmin watches. Works for me, but no guarantees are given. If it +bricks your device you're responsible, not me. + +How to use +---------- +Example use (list all entries in LCTNS.FIT by default): + + % ./lctns-cli + 0: Garmin (N 38°51'19.976", W 94°47'56.468") + 1: Garmin Europe (N 50°58'58.367", W 1°27'50.040") + 2: Garmin Taiwan (N 25°3'42.418", E 121°38'24.959") + +Example use (replace first entry with a decent café): + + % ./lctns-cli --input LCTNS.FIT --output EDITED.FIT --entry 0 \ + --name 'Tjili pop' --latitude "N 55°41.184'" --longitude "E 12°33.014'" + Tjili pop (N 55°41'11.045", E 12°33'0.838") + +New entries should appear after copying the generated output file to the +`GARMIN/NEWFILES/LCTNS.FIT` on your watch after having mounted it as a usb +storage device. + +It is only possible to edit existing entries. It is not possible to add new +ones or remove from the file. It seems the firmware on the device will add all +new entries without overwriting any. + +Install +------- +You'll need [`git`][] and [`cargo`][rustup]. Cloning with git from +<https://git.netizen.se/lctns-cli/> and running `cargo install --path .` should +place `lctns-cli` in `~/.cargo/bin/` by default. + +The code is still too much of a prototype, and far from sufficiently tested, +for it to be suitable to distribute to non-developers. + +I would consider publishing to <https://crates.io/>, but likely not until it +becomes [possible to use crates.io without relying on GitHub][msgh_required]. + +License and disclaimer +---------------------- +MIT. Garmin makes great products, but this tool has nothing to do with them. +They own their trademarks et cetera and would unlikely recommend using anything +with their products not developed by them. You are using this at your own risk. + +Feedback +-------- +Constructive feedback is always welcome. The same goes for patches. Contact +details are easily found at: <https://www.netizen.se/>. + +[git]: https://git-scm.com/ +[rustup]: https://rustup.rs/ +[msgh_required]: https://github.com/rust-lang/crates.io/issues/326 |