microsoft / satellite-imagery-labeling-tool

This is a lightweight web-interface for creating and sharing vector annotations over satellite/aerial imagery scenes.
MIT License
263 stars 31 forks source link

Local execution and modification #27

Closed patel-zeel closed 2 months ago

patel-zeel commented 2 months ago

Hi,

Is it possible to download and run this project locally? My primary motivation behind this is to be able to add/modify some features of the project based on our application.

I tried cloning this repo and opening the src/labeler.html file locally, but it didn't work. image

Edit:

I just saw this help. I am trying it but meanwhile I'd appreciate any help from the developers such as steps to follow to get it working locally. I am trying to do this on Macbook Pro M1 (2020) if that helps.

rbrundritt commented 2 months ago

Yes, it can be run locally, but it needs to be hosted on localhost, not just the filesystem (browsers generally limit access to the local filesystem). This is why the web page is unable to load the labeler.js file.

An easy option is to use VSCode (that is what was used to build this project) or Visual studio.

In VSCode, I use an extension that deploys to localhost automatically called "Live Server". https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer Once that is installed, simple right click on the webpage and click on "Open with Live Server".

If you are using the full-blown Visual Studio, you can simply right click on the webpage and select "view in browser" and it will automatically deploy it to localhost.

patel-zeel commented 2 months ago

https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer

This extension worked smoothly. Thank you for a quick and fully working solution, @rbrundritt! Closing the issue.

nipunbatra commented 2 months ago

Or, just run with

@rbrundritt would it be useful to add this information somewhere in the repo readme/documentation? If so, @patel-zeel or I could do a quick PR.