Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mrusme/mercator
OpenStreetMap but as terminal user interface (TUI) program
https://github.com/mrusme/mercator
bubble bubbletea cli command-line command-line-tool map maps openstreetmap osm terminal terminal-app terminal-based tui
Last synced: about 2 months ago
JSON representation
OpenStreetMap but as terminal user interface (TUI) program
- Host: GitHub
- URL: https://github.com/mrusme/mercator
- Owner: mrusme
- License: gpl-3.0
- Created: 2023-01-15T05:21:57.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-30T18:24:59.000Z (3 months ago)
- Last Synced: 2024-03-30T19:32:23.571Z (3 months ago)
- Topics: bubble, bubbletea, cli, command-line, command-line-tool, map, maps, openstreetmap, osm, terminal, terminal-app, terminal-based, tui
- Language: Go
- Homepage: https://xn--gckvb8fzb.com
- Size: 11 MB
- Stars: 70
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- cli-apps - Mercator - OpenStreetMap but as terminal user interface (TUI) program. (<a name="graphics"></a>Graphics)
- awesome-cli-apps - Mercator - OpenStreetMap but as terminal user interface (TUI) program. (<a name="graphics"></a>Graphics)
README
Mercator
--------
OpenStreetMap but as terminal user interface (TUI) program and [Bubble
Tea](https://github.com/charmbracelet/bubbletea) Bubble.
## Build
```sh
$ go get
$ go build .
```
The binary is called `mercator`
## Usage
`mercator` accepts latitude and longitude as arguments, e.g.:
```sh
$ mercator 25.0782266 -77.3383438
```
It also accepts a location name or address, e.g.:
```sh
$ mercator miami
```
### Style
`mercator` accepts the `-style` flag with an integer value representing one of
the options [listed as
`Style`](https://github.com/mrusme/mercator/blob/master/mapview/mapview.go#L24),
e.g.:
```sh
$ mercator -style 4 new york
```
### Navigation
- `arrow up`/`k`: Move north
- `arrow right`/`l`: Move east
- `arrow down`/`j`: Move south
- `arrow left`/`h`: Move west
- `-`/`_`: Zoom out
- `+`/`=`: Zoom in
## Bubble
You can embed the `mapview` into your Bubble Tea application:
```go
package main
import (
tea "github.com/charmbracelet/bubbletea"
"github.com/mrusme/mercator/mapview"
)
type model struct {
mv mapview.Model
}
func main() {
m := NewModel()
m.mv.SetLocation("jamaica", 15)
p := tea.NewProgram(m, tea.WithAltScreen())
if _, err := p.Run(); err != nil {
panic(err)
}
}
func NewModel() model {
m := model{}
m.mv = mapview.New(80, 24)
return m
}
func (m model) Init() tea.Cmd {
return tea.Batch(tea.EnterAltScreen)
}
func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
switch mt := msg.(type) {
case tea.KeyMsg:
switch mt.String() {
case "q", "esc", "ctrl+c":
return m, tea.Quit
}
case tea.WindowSizeMsg:
m.mv.Width = mt.Width
m.mv.Height = mt.Height
return m, nil
}
var cmd tea.Cmd
m.mv, cmd = m.mv.Update(msg)
return m, cmd
}
func (m model) View() string {
return m.mv.View()
}
```