https://github.com/pjsier/echomap

Preview map files in the terminal
https://github.com/pjsier/echomap

cli geospatial gis hacktoberfest rust

Last synced: about 1 year ago
JSON representation

Preview map files in the terminal

• Host: GitHub
• URL: https://github.com/pjsier/echomap
• Owner: pjsier
• License: mit
• Created: 2019-09-02T16:53:15.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2023-04-11T01:45:22.000Z (about 3 years ago)
• Last Synced: 2025-04-08T09:08:15.252Z (about 1 year ago)
• Topics: cli, geospatial, gis, hacktoberfest, rust
• Language: Rust
• Homepage: https://crates.io/crates/echomap
• Size: 372 KB
• Stars: 16
• Watchers: 2
• Forks: 2
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# `echomap`

[![crates.io](https://img.shields.io/crates/v/echomap.svg)](https://crates.io/crates/echomap)

[![Build status](https://github.com/pjsier/echomap/workflows/CI/badge.svg)](https://github.com/pjsier/echomap/actions?query=workflow%3ACI)

Preview map files in the terminal

![Terminal recording gif](https://raw.githubusercontent.com/pjsier/echomap/main/img/recording.gif?raw=true)

## Installation

If you have `cargo` installed, you can run `cargo install echomap` and then run it from `$HOME/.cargo/bin`. More details on this are available in [`cargo-install` documentation](https://doc.rust-lang.org/cargo/commands/cargo-install.html).

There are also [binaries available](https://github.com/pjsier/echomap/releases) for MacOS, Windows and Linux.

## Usage

```

USAGE:

    echomap [FLAGS] [OPTIONS] 

FLAGS:

    -a, --area       Print polygon area instead of boundaries

    -h, --help       Prints help information

    -V, --version    Prints version information

OPTIONS:

    -c, --columns         Sets the number of columns (in characters) of the printed output. Defaults to

                                   terminal height minus 1.

    -f, --format           Input file format (tries to infer from file extension by default) [possible values:

                                   geojson, topojson, csv, shp, wkt, polyline, kml]

        --lat                 Name of latitude column (if format is 'csv')

        --lon                 Name of longitude column (if format is 'csv')

        --precision     Precision value for polyline parsing

    -r, --rows               Sets the number of rows (in characters) of the printed output. Defaults to terminal

                                   width.

    -s, --simplify       Proportion of removable points to remove (0-1 or 0%-100%) [default: 0.01]

ARGS:

        File to parse or '-' to read stdin

```

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md)