GNU General Public License v3.0

项目介绍

seanmorley15/AdventureLog 是一个托管在 GitHub 上的开源项目,主要使用 Svelte 编写,采用 GNU General Public License v3.0 许可证,目前获得 3.9k 个 Star、265 次 Fork。

仓库全名
seanmorley15/AdventureLog
开源许可证
GNU General Public License v3.0
Star 数
3.9k
Fork 数
265
未关闭 Issue
243

README 摘要

AdventureLog The ultimate travel companion — log where you've been, plan what's next, and see your whole world on one map. Live Demo · Get Started · Quick Install · Documentation · Discord · Support the project 📍 Log travel experiences Locations, visits, photos, trails & activities ✈️ Plan trips Itineraries, checklists, calendar & shared planning 🌍 Track the world Countries, regions, cities & travel…

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

常见问题

AdventureLog 用什么语言开发?

主要使用 Svelte 编写,采用 GNU General Public License v3.0 许可证,目前有 3.9k 个 Star。

AdventureLog 可以免费商用吗?

仓库标注的许可证为 GNU General Public License v3.0,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 AdventureLog 的源码?

可以直接克隆仓库:git clone https://github.com/seanmorley15/AdventureLog.git;安装与运行步骤见仓库 README。

AdventureLog 最近还在维护吗?

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

关于

GitHub 原始描述(英文)

Self-hostable travel tracker and trip planner.

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

语言占比

CSS
Dockerfile
HCL
HTML
JavaScript
Python
Shell
Svelte
TypeScript

README

AdventureLog logo

AdventureLog

The ultimate travel companion — log where you’ve been, plan what’s next, and see your whole world on one map.

License: GPL v3 Docker Self-Hosted Discord GitHub stars

Live Demo · Get Started · Quick Install · Documentation · Discord · Support the project


📍 Log travel experiences
Locations, visits, photos, trails & activities
✈️ Plan trips
Itineraries, checklists, calendar & shared planning
🌍 Track the world
Countries, regions, cities & travel stats
🔒 Own your data
Open source, self-hosted, GPL-3.0

What is AdventureLog?

AdventureLog is a modern open-source travel companion. Pin every place you’ve visited, build multi-day trip itineraries, mark countries and regions on an interactive world map, and collaborate with the people you travel with. It integrates with your existing tools and services to help you plan your next unforgettable adventure.

Built for travelers who want to track, plan, and remember their travel experiences.

See it in action

Interactive world map with location pins and visit filters
Interactive world map — every location, visit status, and filter at a glance

Location list with filters and categories
Locations — browse, filter, categorize & organize
Travel statistics dashboard
Dashboard — travel stats, progress & milestones

Trip itinerary planner with daily activities and lodging
Trip planning — itineraries, notes & daily activities

World travel book with countries visited
World travel — countries, regions & cities
Trip statistics with geographic breakdown and timeline
Trip stats — costs, geography & per-trip milestones
More screenshots

Location detail view with notes and rating
Rich location details — dates, notes, ratings & visit history

3D satellite map view of travel locations
3D satellite view — explore your travel history immersively

Regional map for tracking sub-country travel
Regions — drill into states, provinces & territories

Features

Feature What you get
📍 Locations & visits Pin places on the map with dates, notes, photos, categories, tags, and multi-visit history
🗺️ Interactive map Filter by visited / planned, add locations by click, 2D & 3D views
✈️ Trip itineraries Multi-day collections with flights, lodging, checklists, links & calendar views
🤝 Collaboration Share locations and itineraries via public links or invite other users to edit together
🌍 World travel book Track countries, regions, and cities — with stats and progress milestones
🥾 Trails & activities Attach hiking routes, GPX tracks, distance, elevation & outdoor activity logs
🔍 Search & organize Full-text search, custom categories, public/private visibility
🔐 Security MFA, API keys, social auth (Google, GitHub, Authelia & more)

Integrations

Connect the tools you already use:

Integration Purpose
Immich Link photos from your self-hosted media library
Strava Import activities with GPX tracks & stats
Endurain Import activities with GPX tracks & stats
Wanderer Attach trails with distance & elevation data
Google Maps Geocoding & location search

Why AdventureLog?

AdventureLog Typical closed travel apps
Ownership Your data on your server Locked in a vendor cloud
Cost Free to self-host (GPL-3.0) Subscriptions & upsells
Privacy You control access & sharing Opaque data policies
Customization Open source — extend & integrate Fixed feature set
Scope Locations, itineraries & world travel in one app Split across multiple tools

Quick start

Not sure which setup fits you? The Getting Started guide covers every install path — Docker, homelab NAS, Kubernetes, reverse proxies, and more.

The fastest way to get running — one container, one port:

curl -sSL https://get.adventurelog.app | bash

Or follow the Standard Deployment guide for Docker Compose.

Requirements: Docker Engine + Compose v2 · 2 GB RAM on first boot · Linux, VPS, homelab, or macOS

I want to… Guide
See all install options Getting Started
Try before installing Live demo
One-command install Quick Start Installer
Deploy on Proxmox / Synology / Unraid Platform guides
Run on Kubernetes Kustomize guide
Learn the app Usage guide

Default login is admin / admin — it’s recommended to change it immediately after first sign-in.

Tech stack

Frontend
Backend
Deployment
  • Docker & Docker Compose (recommended)
  • Kubernetes (Kustomize)
  • Reverse proxy guides for Nginx, Traefik & Caddy

Roadmap

Track what’s coming next on the public roadmap →

Contributing

Contributions are welcome! See CONTRIBUTING.md to get started.

Contributors

Translation

Help translate AdventureLog on Weblate:

Translation status

License

Distributed under the GNU General Public License v3.0.

About the creator

Sean Morley — I’m an Electrical Engineering student at UConn, an open-source developer, and an avid traveler. AdventureLog started as my simple idea to track where I’ve been and grew into a full travel companion built for people who love exploring the world. I’m passionate about open-source software and building tools that solve real problems for real people. Feel free to reach out to me directly via the info on my website if you have any questions or feedback! :)

Want the full origin story? Read the Development Timeline.

Acknowledgements

Supporters

AdventureLog is built and maintained as an open-source project. These supporters help make continued development possible.

Individual supporters

Huge thanks to Veymax, Mathias Ponnwitz, nebriv, Miguel Cruz, and Victor Butler.

Become a supporter

Your support funds new features, infrastructure, and continued open-source development.

Become a Sponsor →

评论

暂无评论