Flutter application that presents the history and heritage of a city on a Liquid Galaxy rig. The current content is Lleida (Catalonia): points of interest, cathedrals and churches, museums, and historical events.
Repository: LiquidGalaxyLAB/lg-city-historic-engine
- Name of the Project
- Project Description
- Frontend Development
- Integration with Liquid Galaxy
- Personal Information
City Historic Engine (CHE) — lg-city-historic-engine
Developed at Lleida Liquid Galaxy LAB for the Liquid Galaxy Project.
City Historic Engine makes historical and cultural information easier to explore by combining a mobile catalog with the visualization power of Liquid Galaxy (Google Earth on a multi-screen panoramic rig).
From the app you can:
- Browse four categories: Points of Interest, Cathedrals & Churches, Museums, and Historical Events
- Search and filter places, then open a detail view with image, era, dates, and description
- Send a place to the Liquid Galaxy: the camera flies there, a balloon shows the story, and (when available) a wide image is shown across the central screens
- Orbit around the site and listen to the same text as the balloon (text-to-speech)
- Manage the rig from Tools: relaunch, reboot, shutdown, clean KMLs, show/hide logos
The app works as a catalog on its own. Connecting to Liquid Galaxy is optional and unlocks the immersive view.
Languages: English, Spanish, Catalan, Turkish
Theme: light and dark
Built with Flutter. The UI is organized by screens; Liquid Galaxy communication lives in services, not in the widgets.
| Area | Technology |
|---|---|
| UI | Flutter (Material), custom theme |
| Connection to the rig | SSH (dartssh2) |
| Local settings | shared_preferences |
| Localized place texts | SQLite (sqflite) |
| Images / panorama slices | image |
| Narration | flutter_tts |
- Splash
- Home with the four categories
- Category list (search + filters)
- Launch screen for the selected place (send to LG, orbit, narration)
- Side menu: Connect, Tools, Settings, Help, About
lib/
screens/ UI pages (home, categories, connect, tools, settings…)
widgets/ Shared UI (top bar, cards, menu, headers)
services/ Liquid Galaxy, Chromium panoramas, narration, localization
models/ POI model and SSH connection state
kmls/ KML builders (logos, balloons, placemarks, outlines)
data/ Place catalogs (names, outlines, Chromium images, Lleida seed)
i18n/ UI translations (en / es / ca / tr)
theme/ Light and dark theme
Category screens hold the places shown in the lists. A local database is used to enrich names and descriptions by language. Liquid Galaxy sending does not depend on changing that split.
Requirements
- Flutter SDK (3.x)
- Android Studio (or another IDE) with an emulator or a device
- On Windows, enable Developer Mode so Flutter can create plugin symlinks
(Settings → For developers, orstart ms-settings:developers)
git clone https://github.com/LiquidGalaxyLAB/lg-city-historic-engine.git
cd lg-city-historic-engine
flutter pub get
flutter runOpen the folder that contains pubspec.yaml (the project root), not the android/ subfolder.
The app talks to the master machine (lg1) over SSH. Google Earth on each screen reloads KML files served from http://lg1:81/.
Open Connect and fill in:
| Field | Typical value |
|---|---|
| User LG | lg |
| Password LG | lg |
| IP | IP of lg1 on the local network |
| Port | 22 |
| Password Admin | sudo password of the rig |
| Screens | 5 (or the number of screens in your rig) |
On success, credentials are saved and the partner logos are sent to the leftmost screen.
LGService.presentPoi runs a queued pipeline so two taps cannot overlap on the rig:
- SSH session is checked (and reconnected if needed)
- Previous balloon is hidden
- If the place has a wide Chromium image, it is sliced and shown on the three central screens
- Camera FlyTo the stored LookAt (lat, lng, range, heading, tilt)
- For buildings: OSM-based ground outline + placemark. For historical events: outline is cleared so the story stays in the balloon
- Balloon with the localized name, era, dates, and description
- From the launch screen you can orbit and narrate (TTS uses the same text as the balloon)
KML files follow the Liquid Galaxy solo-KML convention: master_1.kml on the center machine, slave_N.kml on the others.
From Tools, with an active connection:
- Relaunch Liquid Galaxy
- Reboot / shutdown the rig
- Clean KMLs
- Clean logos / show or hide logos
These actions require SSH access and the admin password configured on Connect.
To install or refresh a rig, see the Liquid Galaxy LAB setup guide.
| Role | Name |
|---|---|
| Author | Yasmina Ramadan |
| Contact | yasiramadan@gmail.com |
| Mentor | Claudia Diosan |
| Organization administrator | Andreu Ibáñez |
| Support | Lleida Liquid Galaxy LAB |
| Logo designer | Paula Torne |
| History information | Alex Moix |
| Coordinates | David López Solá & Adrià Ballesteros Oro |
More about the organization: liquidgalaxy.eu
LG City Historic Engine is licensed under the MIT License