Code Monkey home page Code Monkey logo

mbview-rs's Introduction

MBTiles Viewer, a cross-platform MBTiles Viewer.

Windows Support Ubuntu Support Arch Linux Support Windows Support


What is MBTiles Viewer?

Demo

MBTiles Viewer is a tool to view and inspect mbtiles files without the need of running a docker or a web server

  • 100% offline
  • load vector mbtiles
    • See all layers
    • hide/show layers
    • filter lines/polygons/points
    • click or shift+move to inspect map elements
    • bottom panel to view features details
  • load raster mbtiles
  • load multiple mbtiles on the same map
  • split feature to view/compare mbtiles side by side
  • multiple themes
  • localized (fr/en for now)

You can give your suggestions and feedback on our Discussions page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to contribute to this project.


Project Roadmap

Recommend us a feature by opening an Discussion if you'd like to.


Installation

If you want to install on your system, you can download the installer for your operating system on the release page.


Bug Reporting

If you find any bugs, please report it by submitting an issue on our issue page with a detailed explanation. Giving some screenshots would also be very helpful.

Feature Request

You can also submit a feature request on our issue page or discussions and we will try to implement it as soon as possible. If you want to contribute to this project, please contribute to this project.


Development

If you want to run this project in your local system, please follow this guide:

  1. Fork this project

  2. Clone the project to your local system using this command

  3. Follow this guide to set up Tauri environment

$ git clone https://github.com/<your_github_username>/mbview-rs.git
  1. Change directory to the root directory of this project
$ cd mbview-rs
  1. Install all dependencies using pnpm or yarn
$ pnpm install
  1. Run the project in development mode. Please note that it might takes some times for Cargo to install dependencies for the first run.
$ pnpm dev

Contribution Guide

We highly encourage you to contribute to this project (even if you are a beginner). And if you finally want to contribute to this project, please read our contribution guide.


LICENSE

Apache-2.0

mbview-rs's People

Contributors

farfromrefug avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

mbview-rs's Issues

contribution guide link is to a different project

The "contribution guide" link in the readme goes to https://xplorer.space/docs/community/Contributing. I'm not sure if this is intentional but, since there's no apparent relationship between the two projects, it would be better for this project to have its own contribution guide.

Thanks for the cool project by the way, I'm looking forward to contributing once I familiarise myself with the codebase! :-)

Failed to start the project

Description

Cloned the project and install the dependencies. I run pnpm dev:web successfully but when open the web, it will report window.__TAURI_IPC__ is not a function instantly in console. And when click the add another mbtiles file (extract from OSM, so the file itself is fine), there will be no response, and console will show window.__TAURI_IPC__ is not a function again.
Same when running pnpm dev, the macOS app appears but once click add another mbtiles, no response, and show following logs

2023-03-07 14:39:04.627 MBTilesViewer[77582:2463167] +[CATransaction synchronize] called within transaction
thread 'tokio-runtime-worker' panicked at 'called `Option::unwrap()` on a `None` value', src/service.rs:118:60
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
thread 'tokio-runtime-worker' panicked at 'called `Option::unwrap()` on a `None` value', src/service.rs:118:60
thread 'tokio-runtime-worker' panicked at 'called `Option::unwrap()` on a `None` value', src/service.rs:118:60
๐Ÿš€ A new version of Tauri CLI is available! [1.2.3]

And the Tauri info:

~ tauri info

Environment
  โ€บ OS: Mac OS 13.2.1 X64
  โ€บ Node.js: 18.9.0
  โ€บ npm: 8.19.1
  โ€บ pnpm: 7.24.2
  โ€บ yarn: 1.22.19
  โ€บ rustup: 1.25.2
  โ€บ rustc: 1.67.1
  โ€บ cargo: 1.67.1
  โ€บ Rust toolchain: stable-aarch64-apple-darwin 

Packages
  โ€บ @tauri-apps/cli [NPM]: 1.1.1 (outdated, latest: 1.2.3)
  โ€บ @tauri-apps/api [NPM]: 1.1.0 (outdated, latest: 1.2.0)
  โ€บ tauri [RUST]: 1.1.1,
  โ€บ tauri-build [RUST]: 1.1.1,
  โ€บ tao [RUST]: 0.14.0,
  โ€บ wry [RUST]: 0.21.1,

App
  โ€บ build-type: bundle
  โ€บ CSP: default-src blob: data: filesystem: ws: wss: asset: mbtiles: http: https: tauri: 'unsafe-eval' 'unsafe-inline' 'self' img-src: 'self'; worker-src blob:
  โ€บ distDir: ../build
  โ€บ devPath: http://localhost:3000/
  โ€บ framework: Svelte

App directory structure
  โ”œโ”€ resources
  โ”œโ”€ node_modules
  โ”œโ”€ public
  โ”œโ”€ .github
  โ”œโ”€ src-tauri
  โ”œโ”€ build
  โ”œโ”€ .git
  โ”œโ”€ .idea
  โ””โ”€ src

Disclaimer, I'm not familar with Rust & Tauri, so I'm not sure is that some steps missing and caused this.
Thanks in advance!
BTW, download and install the bundle App from the releases, it will quit once click on add another mbtiles as well

Steps To Reproduce

  1. Cloned this repo locally
  2. pnpm install dependencice
  3. pnpm upgrade // I think this is not the blame
  4. install rust
  5. pnpm dev // pnpm dev:web

Expected behavior

When add another mbtiles, it should show the mbtiles.

App Version

v1.6.0

Operating System Version

macOS Ventura 13.2.1, M1 chip

Additional Information

No response

Broken at least on linux

Description

  • Buttons to add map do nothing, I guess they should open file picker
  • Drag and drop looks like it will work (displays file name) but the maps do not load (blank scren)

Ubuntu 22.04, installed from 1.7.0 deb file

Steps To Reproduce

No response

Expected behavior

app should do something

App Version

1.7.0 deb

Operating System Version

Ubuntu 22.04

Additional Information

No response

open .mbtiles but the map doesn't show up

Description

my pc spec i5 1135g7 ram 8 win 10
i download mbtiles file from osm qa tiles map for thailand
but when i open this file it doesn't show a map

Steps To Reproduce

open a mbtiles file

Expected behavior

i don't know

App Version

v1.6.0

Operating System Version

win10 21h2

Additional Information

doesn't show me anything

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.