MIT License

项目介绍

kylecorry31/Trail-Sense 是一个托管在 GitHub 上的开源项目,主要使用 Kotlin 编写,采用 MIT License 许可证,目前获得 3.0k 个 Star、182 次 Fork。

仓库全名
kylecorry31/Trail-Sense
开源许可证
MIT License
Star 数
3.0k
Fork 数
182
未关闭 Issue
315

README 摘要

Trail Sense Trail Sense is an offline multi-tool Android app for hiking, backpacking, camping, wilderness survival, foraging, and hunting. [!IMPORTANT] Trail Sense is a tool, and like any other tool you bring into the wilderness, it's essential to have backup equipment and the skills to stay safe without it. Never rely on it alone. F-Droid Google Play Obtainium Survival Guide Features Navigate using beacons…

完整内容见 GitHub 原始 README 或本页 。

常见问题

Trail-Sense 用什么语言开发?

主要使用 Kotlin 编写,采用 MIT License 许可证,目前有 3.0k 个 Star。

Trail-Sense 可以免费商用吗?

仓库采用 MIT License 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 Trail-Sense 的源码?

可以直接克隆仓库:git clone https://github.com/kylecorry31/Trail-Sense.git,默认分支为 main;安装与运行步骤见仓库 README。

Trail-Sense 最近还在维护吗?

仓库最近一次更新为 14 小时前,当前有 315 个未关闭 Issue;Star 数为 3.0k,可作为社区活跃度的参考。

关于

GitHub 原始描述(英文)

An Android app that uses your phone's sensors to assist with wilderness treks or survival situations.

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

简要分析

热度分
3396
价值分
1848
活跃状态
活跃

语言占比

Batchfile
CSS
HTML
Kotlin
Python
Shell
TeX

Release

README

Trail Sense

Trail Sense is an offline multi-tool Android app for hiking, backpacking, camping, wilderness survival, foraging, and hunting.

Important 重要

Trail Sense is a tool, and like any other tool you bring into the wilderness, it’s essential to have backup equipment and the skills to stay safe without it. Never rely on it alone.

F-Droid Google Play Obtainium Survival Guide
Get it on F-Droid Get it on Google Play Get it on Obtainium Get the book

Features

  • Navigate using beacons (waypoints), paths, and bearings
  • Retrace your steps with backtrack
  • Use a photo as a map
  • View offline maps
  • Plan what to pack
  • Be alerted before the sun sets
  • Predict the weather and tides
  • Use your phone as a flashlight
  • And much more!

See the project board for the current priority order of planned features. There are no associated release dates. Since Trail Sense is a hobby project that I also use daily, priorities may change as my interests and needs evolve.

See the need for a new feature? Post it here!

Documentation

See the User Guide for a guide on how to use Trail Sense. This is also available in the app, just search on the Tools tab for User Guide.

See the Technical Blog / Research for technical details about how I implemented a few of the features.

Privacy

Trail Sense does not require an Internet connection. All app data, including location history, is stored in the app’s private local storage, which is inaccessible to other apps. This data is cleared when you clear Trail Sense’s app storage or uninstall it.

Permissions

Sensitive
  • POST_NOTIFICATIONS
    • Allows Trail Sense to display notifications (backtrack, weather, sunset alerts, astronomy events, water boil timer, etc)
    • When denied: Alerts will not be displayed and some services may not function properly depending on your device manufacturer.
  • ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION
    • Allows Trail Sense to retrieve your location for navigation, weather (sea level calibration), and astronomy.
    • When denied: You will have the ability to mock your location under Settings > Sensors > GPS. On Android 14+, backtrack and weather will be unavailable due to Android OS constraints.
  • ACCESS_BACKGROUND_LOCATION
    • Allows Trail Sense to retrieve your location for sunset alerts while in the background. On some devices, this will also improve the reliability of backtrack and weather monitor (though shouldn’t be needed on most devices).
    • When denied: If you travel and do not open Trail Sense, but have Sunset and Sunrise Alerts enabled, the times will likely be inaccurate.
  • ACTIVITY_RECOGNITION
    • Allows Trail Sense to use your phone’s pedometer for distance calculation.
    • When denied: The pedometer will not work.
  • CAMERA
    • Allows Trail Sense to use your camera on the sighting compass, clinometer, and for taking photos used by the Cloud Scanner, QR Code Scanner, and Photo maps.
    • When denied: You will not be able to use the sighting compass, camera clinometer, or QR Code Scanner. You will need to pick an existing photo to use for the Cloud Scanner or Photo maps.
  • SCHEDULE_EXACT_ALARM
    • Allows Trail Sense to post a notification at an exact time. This is used by the Clock tool (when updating system time) and Sunset and Sunrise Alerts.
    • When denied: The clock and sunset alerts may not be accurate (can be off by several minutes).
Not sensitive (always granted)
  • RECEIVE_BOOT_COMPLETED
    • Allows Trail Sense to restart when you reboot your device. This will re-enable backtrack, weather monitor, and several other background services.
  • FOREGROUND_SERVICE
    • Allows Trail Sense to start foreground services, such as backtrack and weather monitor.
    • You may see subtypes of the foreground service permission granted, labeled as FOREGROUND_SERVICE_*. These describe specific types of foreground services, such as location, health, special use, and media playback.
  • FLASHLIGHT
    • Allows Trail Sense to control the phone’s flashlight.
  • VIBRATE
    • Allows Trail Sense to vibrate the phone. Used for haptic feedback on dials and on the metal detector tool.
  • WAKE_LOCK
    • Allows Trail Sense to reliably run services such as backtrack and weather monitor, especially when the frequency is under 15 minutes.

Contributing

See the CONTRIBUTING.md file for details on contributing to Trail Sense.

Copying

You are allowed to create copies of Trail Sense and rebrand to what you see fit. The app code is under the MIT license. The Survival Guide content is under its own license, so check the Survival Guide License before reusing it.

Please change the following if you are using this as the base for your app:

  • App name
  • Package name
  • Support email
  • App icon (optional)

FAQ

The FAQ can be found on the website

Open Source Credits

License

License

评论

暂无评论