Creating a watch face in the Connect IQ Store app. Select Camera to take a new picture or Photos to use a photo in your camera roll. Arrange the photo, and choose a display. Once the watch has synced, 1 the custom watch face will then be available on the device. Refer to your owner's manual for steps on enabling the watch face.
Time is an illusion. (Albert Einstein)
Lunchtime – doubly so. (Douglas Adams)
There’s a good chance you’re wearing a watch on your wrist right now, and if you’re not wearing a horologically significant or sentimental time piece you’re probably wearing a smart watch, and if you’re wearing a smart watch it should be a Garmin watch (they did NOT pay me to say this)
Aug 26, 2021 I just launched a Garmin device watch face app online builder. Garmin App Online Builder (joshuahxh.com) It's still in beta testing stage. I'm still trying to figure out how to compile the app in Linux. In the meantime I'm just run a script to build the app once every seconds. The Face-It watch face app lets you customize your watch face with any photo from your mobile device. Download the app, choose an image from your photo library, add the time and set it as your watch’s face. Whether it’s a scenic view from your last hike or a picture of your new puppy, the Face-It app lets you add personality to your watch that’s uniquely you.
Garmin watches are awesome. They are rugged, they hold the battery charge for days, some models even weeks, and they are highly customizable.
It is that last aspect that we’re going to concentrate on in this tutorial.
Garmin has an equivalent of Apple App Store (good name) or Google Play Store (horrible name), and it’s called Garmin Connect IQ Store (I’d like to be in that naming meeting)
App development for Garmin watches is done using proprietary language “Monkey C” (https://developer.garmin.com/connect-iq/monkey-c/) (probably named in that same meeting after everyone got drunk)
…yeah, really! What’s next? Monkey Do?
So, with that in mind, we’re going to design and implement a watch dial in monkey-c and deploy it to Garmin’s IQ store.
I wanted the watch face to look like Casio G-Shock because they are awesome, particularly G-LIDE model (GBX100)
I wanted the dial to show time, date, weather, pulse, steps, calories, distance walked today, and battery charge. I didn’t want to ask users for any extra permissions and I wanted this app to be as easy on the battery as possible, without any background processing.
I went on to design the dial on a piece of paper as I’ve heard that designing upfront makes the whole development process easier, and so I went through a couple of iterations.
Nothing exciting to talk about here, I just followed Garmin’s getting started guide: https://developer.garmin.com/connect-iq/connect-iq-basics/getting-started/
In short, you’ll need to download and install the Connect IQ SDK, sign up for dev account, install Eclipse (yuck) if you don’t already have one, install Connect IQ Eclipse plug-in, which turns Eclipse into a Connect IQ development environment, and generate dev key.
The installation will be somewhat painful if it’s your first development endeavor, but nothing like installation of an IBM Websphere Portal.
After all installation is done you can go ahead and create your own sample app to make sure everything works.
Follow this: https://developer.garmin.com/connect-iq/connect-iq-basics/your-first-app/
Once all steps are completed, run the app and this is what you’ll see in a simulator:
If you followed the instructions to the letter then you’ve probably installed command line tools, which give you wonderful commands like:
// Compile the executable:
> monkeyc -d fenix5plus -f /path/to/monkey.jungle -o project_name.prg -y /path/to/Dev_Key
// Run in the simulator
> monkeydo myApp.prg fenix5plus
I’m starting to really like these Garmin folks, they seem to have a sense of humor. Clean install el capitan without usb.
Source code of the sample app looks very much like Android source code, with classes extending Views, xml layouts and referencing elements by id:
Again, the way layout works is very similar to Android, the watch face layout is located in /resources/layouts/layout.xml
It looks like Garmin is running a highly customized version of Android, so Android devs will feel right at home here… if you want a flashback to the early days of Android.
Unlike working in Android Studio however, working in Eclipse feels like I’m back in early 2000s. It’s clunky and unnatural and unintuitive. Something that only takes a few seconds to implement in Android Studio now takes forever in Eclipse. This makes you really appreciate JetBrains’ IDEs (They did not pay me to say this.)
When laying out the elements on the watch face you have to remember that the coordinate system is based on a square screen, so the corners are beyond the round viewport of the watch. So, if you place something in the corners they will not show up, you’ll have to experiment with coordinates, like in the layout I have below:
You can define coordinates in pixels or percent.
I also wanted to display a grid of gray lines, like on Casio watches, this is taken care of by:
<drawable id=“scaffolding”></drawable> which references scaffolding.xml:
At this point all data except for the time is hardcoded. Time to connect it to the real data.
For getting the data on the screen we’ll use
Toybox.ActivityMonitor gives us heart rate, steps, burned calories and distance walked/ran since midnight. The distance is in cm, so we’ll have to convert it to miles or km based on system settings
Toybox.System gives us clock and battery
Toybox.Weather gives us weather
Toybox.Application gives us access to properties that can be set by the user in the app settings.
So now, once we have a layout defined, we can get the element in code by
and set its value, for example for the hours and minutes:
There is a way to create a watch face that would accept users’ custom settings, like for colors, or optional fields on the screen. For this you’ll define resources/settings/settings.xml
and resources/settings/properties.xml
To run settings screen for the simulator, use Eclipse’s ConnectIQ tab, then select App Settings Editor.
One of the main struggles I had was the battery icon. I wanted it to be a proper graph, indicating a real-time charge level. The problem is all Garmin devices have different resolutions, and there’s no notion of DIP in Garmin (Density Independent Pixels) So, I had to create my own DIP calculation:
Please don’t laugh, my brain still hurts.
Oh yeah, and be prepared to draw or modify icons pixel by pixel, and with specific colors Garmin recognizes. I used Gimp, it’s free and it’s awesome:
Anyway, after all said and done here’s what I got:
You can find it in Garmin’s app store here: https://apps.garmin.com/en-US/apps/c2f2b648-ab65-4329-991a-b9f240bcb92f
It’s great to be able to develop watch faces and apps for smart watches, and I feel that Garmin is making the whole process easy for new developers, especially if you have some Android background.
The only suggestion I have is to make the dev environment a little friendlier and documentation more organized. Working with Eclipse and Garmin’s plugin is a huge step back when compared to Android Studio and Intelli-J that it’s based on.
Working with current dev documentation can be frustrating and you’ll end up hunting for a simple answer forever.
Also, there’s a great forum for Garmin devs: https://forums.garmin.com/developer/connect-iq/
You’ll meet a lot of good folks there. They have changed my perspective on Garmin development from negative to positive over the course of 3 weeks.
Developers and the engaging and appreciative users are what made me enjoy the whole process.
Happy coding!
Joe Berger
References:
Special thanks to Joshua Miller for inspiration: https://medium.com/@JoshuaTheMiller/making-a-watchface-for-garmin-devices-8c3ce28cae08
Garmin Face It App For Mac
- Approach® S60
- Approach® S62
- Captain Marvel
- D2™ Air
- D2™ Charlie
- D2™ Delta
- D2™ Delta PX
- D2™ Delta S
- Darth Vader™
- Descent™ Mk1
- Descent™ MK2, Descent™MK2i
- Descent™ Mk2S
- First Avenger
- Forerunner® 245
- Forerunner® 245 Music
- Forerunner® 645
- Forerunner® 645 Music
- Forerunner® 745
- Forerunner® 935
- Forerunner® 945
- Forerunner® 945 LTE
- fēnix® 5, quatix® 5
- fēnix® 5 Plus
- fēnix® 5S
- fēnix® 5S Plus
- fēnix® 5X, tactix® Charlie
- fēnix® 5X Plus
- fēnix® 6
- fēnix® 6 Pro, fēnix® 6 Sapphire
- fēnix® 6 Pro Dual Power
- fēnix® 6 Pro Solar
- fēnix® 6 Solar
- fēnix® 6S
- fēnix® 6S Dual Power
- fēnix® 6S Pro, fēnix® 6S Sapphire
- fēnix® 6S Pro Dual Power
- fēnix® 6S Pro Solar
- fēnix® 6S Solar
- fēnix® 6X Pro, fēnix® 6X Sapphire, fēnix® 6X Pro Solar, tactix® Delta Sapphire, quatix® 6X Solar, tactix® Delta Solar, tactix® Delta Solar Ballisitcs
- fēnix® Chronos
- MARQ™ Adventurer
- MARQ™ Athlete
- MARQ™ Aviator
- MARQ™ Captain, MARQ™ Captain: American Magic Edition
- MARQ™ Commander
- MARQ™ Driver
- MARQ™ Expedition
- MARQ™ Golfer
- Mercedes-Benz Venu®
- quatix® 6
- quatix® 6X, quatix® 6X Solar, quatix® 6X Dual Power
- Rey™
- Venu®
- vívoactive® 3
- vívoactive® 3 Mercedes-Benz® Collection
- vívoactive® 3 Music
- vívoactive® 4, GarminActive
- vívoactive® 4S, GarminActive S
- vívolife
Comments are closed.