https://github.com/face-hh/lawmaxxing
A maps website, that reports you to the police if detected speeding. (self-hosted, calls a number of your choice, a meme)
https://github.com/face-hh/lawmaxxing
facedev mapbox maps sms svelte sveltekit twilio website
Last synced: 8 months ago
JSON representation
A maps website, that reports you to the police if detected speeding. (self-hosted, calls a number of your choice, a meme)
- Host: GitHub
- URL: https://github.com/face-hh/lawmaxxing
- Owner: face-hh
- License: apache-2.0
- Created: 2024-11-01T18:20:10.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-01T18:24:18.000Z (over 1 year ago)
- Last Synced: 2025-08-16T02:53:21.398Z (10 months ago)
- Topics: facedev, mapbox, maps, sms, svelte, sveltekit, twilio, website
- Language: Svelte
- Homepage:
- Size: 80.1 KB
- Stars: 51
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lawmaxxing
A self-hosted web application that demonstrates speed monitoring capabilities using maps. This is a proof-of-concept project meant for **educational purposes only**.
## Legal Disclaimer
THIS SOFTWARE IS PROVIDED FOR EDUCATIONAL AND ENTERTAINMENT PURPOSES ONLY.
- This application is not intended to be used as a law enforcement tool or legitimate speed monitoring system
- Any SMS messages sent by this application are purely demonstrative
- The creators and contributors assume no liability for any misuse of this software
- This is not a substitute for actual law enforcement or emergency services
- If you witness actual traffic violations or emergencies, contact your local authorities through appropriate channels
## Setup
1. Prerequisites:
- [Node.js](https://nodejs.org/en)
- A [Mapbox](https://www.mapbox.com/) account for map functionality
- A [Twilio](https://www.twilio.com/en-us) account for SMS capabilities
2. Environment Variables:
Create a `.env` file in the root directory with the following:
```python
RECEIVER_PHONE_NUMBER=your_phone_number
TWILIO_PHONE_NUMBER=your_twilio_number
TWILIO_ACCOUNT_SID=your_twilio_sid
TWILIO_AUTH_TOKEN=your_twilio_token
```
3. Mapbox Configuration:
- Obtain a Mapbox access token from [Mapbox](https://www.mapbox.com/)
- Replace `REPLACE_ME__BUDDY` in `src/routes/+page.svelte` with your Mapbox token
4. And we're almost done!
```bash
npm install
npm run dev
```
5. If you want to use it on your 📱 phone:
- Easiest way would be to host it on [Vercel](https://vercel.com) (**NOT AFFILIATED**).
- then open the site on your phone (i.e. `https://gpeaoihganebo.vercel.app`).
## Configuration details
- `RECEIVER_PHONE_NUMBER`: The phone number that will receive SMS notifications. Make sure it starts with the receiver's country code, i.e. `+1xxxxx` for the US.
- `TWILIO_PHONE_NUMBER`: Your Twilio-provided phone number for sending SMS.
- `TWILIO_ACCOUNT_SID`: Your Twilio account SID.
- `TWILIO_AUTH_TOKEN`: Your Twilio authentication token.
## Contributing
This is an educational project that has reached a stable state. While you're welcome to fork and modify the codebase for your own learning purposes, please note that this repository is in maintenance mode. New feature requests or pull requests are unlikely to be reviewed or merged, as the project is intended to remain in its current form.
## License
Apache 2.0
---
Remember: This is a demonstration project. Always follow local laws and regulations regarding traffic monitoring and reporting.
Developed by [FaceDev](https://youtube.com/c/FaceDevStuff).