Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .vscode/launch.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"version": "0.2.0",
"configurations": [
{
"type": "aspire",
"request": "launch",
"name": "Aspire: Launch default apphost",
"program": "${workspaceFolder}"
}
]
}
23 changes: 16 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
[![Build](https://github.com/tjmoore/image-mapper/actions/workflows/build.yml/badge.svg)](https://github.com/tjmoore/image-mapper/actions/workflows/build.yml)

ImageMapper is a server hosted application that processes images from a configured server folder,
extracts GPS metadata, and generates an interactive map displaying the locations of these images
extracts GPS metadata, and in a web application generates an interactive map displaying the locations of these images

This application is built using .NET and leverages the Leaflet.js library for map rendering

Expand All @@ -28,32 +28,41 @@ This application is built using .NET and leverages the Leaflet.js library for ma
Set `ImageMapper.AppHost` as start up project and run (F5)

#### Visual Studio Code
From Solution Explorer, right click `ImageMapper.AppHost` and select Debug -> Start New Instance

Install Aspire CLI - https://learn.microsoft.com/en-us/dotnet/aspire/cli/install

Install Aspire Extension - https://learn.microsoft.com/en-us/dotnet/aspire/fundamentals/aspire-vscode-extension

Run with F5 or Run -> Start Debugging

Alternatively without the Aspire CLI / Extension, from Solution Explorer right click `ImageMapper.AppHost` and select Debug -> Start New Instance

#### Command Line
Run `dotnet run --project ImageMapper.AppHost`
Install Aspire CLI - https://learn.microsoft.com/en-us/dotnet/aspire/cli/install

Run `aspire run`

Alternatively without Aspire CLI, run `dotnet run --project ImageMapper.AppHost`

This will run the .NET Aspire host, launching the components and dashboard in the browser showing the service status.

Launch the front end application from imagemapper-web link

Alternatively using Aspire CLI:

`aspire run`

## Configuration

The folder for images can be configured via `appsettings.json` file in ImageMapper.Api project
```json
{
"ImageFolder": "C:\\Path\\To\\Your\\Images"
"ImageFolder": "/path/to/your/images"
}
```

## TODO

- Further unit tests
- Optimise image processing for large number of images and folders
- Abstract file enumeration and loading to allow varied sources not just a file folder
- Caching (minimally in-memory/redis etc, future database caching of metadata. With detection of image file changes)
- Configure map tile provider options
- UI improvements, filtering etc
Expand Down