Table of Contents
This article is about application logging in Android which consists of dumps a log of system messages, including stack traces when the device throws an error and messages that have been written by the application. These can be retrieved via logcat. Gadgetbridge also provides a way to save the application log into a file, which can then be read.
Log File Contents
Please keep in mind Gadgetbridge log files may contain lots of personal information, including but not limited to health data, unique identifiers (such as a device MAC address), music preferences, etc. Additionally, consider that if you used your device with the official app in the past, the Bluetooth log might contain information about your account on the vendor's cloud, including ways to access it. Consider editing the file and removing this information before sending the file to a public issue report.
When sharing a log file, please try to make it as short as possible. If you already had logging enabled, disable and reenable it before doing the things that you want to get logged. Disable logging when you're done with that. That way, we will not have to wade through huge log files looking for the actual relevant lines.
Log File Location
If you enable Gadgetbridge's logging in the "Settings" → "Write Log Files", the log file will be stored in the Export/Import application folder called "files". Location of this application folder depends on Android version but in modern Android, the folder path is /storage/emulated/0/Android/data/nodomain.freeyourgadget/files/
. Older Android might have this folder on your external sdcard in /sdcard/Android/data/nodomain.freeyourgadget.gadgetbridge/files/
. The log file is named gadgetbridge.log
.
Sharing the log file directly
Gadgetbridge offers the possibility to share the log file directly from the app, reducing the need to use the file manager approach outlined below. Go to "Debug" in the menu and click the "Share log" button, then choose which app and/or contact to share the log with.
Accessing the Export/Import folder
The Export/Import folder can be normally accessed via some file manager. Under Android 11 and newer versions, the Export/Import folder can only be accessed via file manager that is using the new Scoped Storage system of Android.
One popular FLOSS file manager which is able to do this is a Simple File Manager Pro, link to: Google Play, F-Droid:
General
- Home
- FAQ
- ReadMe
- Configuration
- Notifications
- ChangeLog
- Widget
- Weather
- Data Backup
- Pairing
- Find phone
- Music info
- Permissions Explained
- Firmware Update
- Automation via Intents
Sports/Activities
- Sports Activities Workouts
- Activity Sessions List
- Activity and Sleep Charts
- Heartrate measurement
- Integrating Sports Tracking apps with Gadgetbridge Sports Activities/Workouts
Smart Device Related
- Bangle.js
- Casio devices
- FitPro
- Fossil Hybrid HR
- Garmin devices
- HPlus
- Huami devices
- Amazfit Active
- Amazfit Active Edge
- Amazfit Balance
- Amazfit Band 5
- Amazfit Band 7
- Amazfit Bip
- Amazfit Bip Lite
- Amazfit Bip S
- Amazfit Bip U
- Amazfit Bip 3 Pro
- Amazfit Bip 5
- Amazfit Cheetah
- Amazfit Cheetah Pro
- Amazfit Cor
- Amazfit Cor 2
- Amazfit Falcon
- Amazfit GTR
- Amazfit GTR 3
- Amazfit GTR 3 Pro
- Amazfit GTR 4
- Amazfit GTR Mini
- Amazfit GTS
- Amazfit GTS 3
- Amazfit GTS 4
- Amazfit GTS 4 Mini
- Amazfit Neo
- Amazfit T-Rex
- Amazfit T-Rex 2
- Amazfit T-Rex Ultra
- Mi Band 1
- Mi Band 2
- Mi Band 3
- Mi Band 4
- Mi Band 5
- Mi Band 6
- Mi Band 7
- MyKronoz ZeTime
- Pebble
- PineTime
- Sony Wena 3
- SMA
- WithingsSteel
Wireless Earbuds
Others
- iTag Keyring trackers
- Nut Keyring trackers
- UM25 USB Voltage meter
- VESC BLDC controller VESC
- Flipper Zero Multi-tool Device for Geeks
- Roidmi Roidmi/Mojietu FM Trans.
- Vibratissimo Private toy
- Shell Racing Toy RC cars
- Femometer Vinca II
Full list of supported devices
Development
- How to Release
- Developer Documentation
- BT Protocol Reverse Engineering
- Support for a new Device
- New Device Tutorial
- Translating Gadgetbridge
- OpenTracks-API
- Intent-API
Feature Discussion
FAQ