https://github.com/pelmers/streetwarp-web
The web-based frontend for streetwarp-cli, a tool that produces hyperlapses for GPX routes
https://github.com/pelmers/streetwarp-web
geospatial-visualization mapbox streetview webapp
Last synced: 4 months ago
JSON representation
The web-based frontend for streetwarp-cli, a tool that produces hyperlapses for GPX routes
- Host: GitHub
- URL: https://github.com/pelmers/streetwarp-web
- Owner: pelmers
- Created: 2020-12-25T23:00:14.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-11-01T10:26:39.000Z (8 months ago)
- Last Synced: 2025-11-01T11:25:29.228Z (8 months ago)
- Topics: geospatial-visualization, mapbox, streetview, webapp
- Language: TypeScript
- Homepage: https://streetwarp.com/
- Size: 14.7 MB
- Stars: 39
- Watchers: 3
- Forks: 3
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://streetwarp.com/)
## Website: [streetwarp.com](https://streetwarp.com)
## Example:
Click to view:
[](https://github.com/pelmers/streetwarp-web/blob/master/res/demo_result.mp4?raw=true)
### Description
Streetwarp Web is the web-based frontend for
[streetwarp-cli](https://github.com/pelmers/streetwarp-cli), a tool that
produces hyperlapses for GPX routes. This project is simply a web page and
associated server that invokes the command line tool. The live deployment uses
[streetwarp-lambda](https://github.com/pelmers/streetwarp-lambda) running on
[AWS Lambda](https://aws.amazon.com/lambda/) to invoke the tool without loading
the web server.
### Features
- Connect to Strava, RideWithGPS, or Google Maps, or upload GPX file directly
- Several output options to trade-off processing speed and result quality
- Animated route during video playback (using [mapbox](https://www.mapbox.com/))
### Development
```
git submodule update --init --recursive
yarn
yarn build
node_modules/.bin/ts-node src/server.ts --streetwarp-bin= [--debug]
```
The following environment variables should be set:
```
AWS_ACCESS_KEY
AWS_LAMBDA_REGION
GOOGLE_API_KEY (used for metadata requests, which don't incur cost)
STRAVA_CLIENT_ID
STRAVA_REDIRECT_URI
STRAVA_CLIENT_SECRET
MAPBOX_API_KEY
```
### Deployment
```
git submodule update --init --recursive
docker run --init -it --rm -p 4041:4041 -v $(pwd)/video:/app/video [env vars] streetwarp-web
```
Use `-e env_var=value` for all the required variables listed above.
### Recent Changes
- Added option to make video public and list on home page
- Integration with [GPX Replay](https://gpx.pelmers.com) for more interactive map display
- Display elevation profile on results for supported routes
- Renamed "quality" button to "smooth"