aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorParker <contact@pkrm.dev>2024-06-24 16:24:09 -0500
committerParker <contact@pkrm.dev>2024-06-24 16:24:09 -0500
commit5b92454760a8af14bd1031e72024946f868d1de6 (patch)
treef8384cbf0d142777d9bff341e13fd5882182908b /README.md
parent80a39d38bf829193c655a7320c86df2a3146db2a (diff)
Major overhaul + Bare bones web UI
Diffstat (limited to 'README.md')
-rw-r--r--README.md88
1 files changed, 53 insertions, 35 deletions
diff --git a/README.md b/README.md
index 32453c1..3cc7020 100644
--- a/README.md
+++ b/README.md
@@ -1,38 +1,56 @@
+<h1 align="center">
+ LinkLogger
+</h1>
-# LinkLogger API
-
-A simple API for you to create redirect links on my domain (link.pkrm.dev) and log all IPs that click on the link. Essentially just grabify with no GUI.
-
-Feel free to submit an issue for any problems you experience or if you have an idea for a new feature. If you have a fix for anything, please submit a pull request for review.
-
-## Want to self-host?
-
-#### Bare metal
-Feel free to fork this code and run it yourself, simply install the dependencies, create your `.env` file and run the `linklogger.py` file.
-
-#### Docker
-Use the docker-compose below as an example of running LinkLogger in docker.
-```yaml
-version: '3.3'
-services:
- linklogger:
- container_name: linklogger
- image: ghcr.io/packetparker/linklogger:latest
- network_mode: host
- environment:
- - BASE_URL=https://your.domain
- - IP_TO_LOCATION=True
- - API_KEY=Your Key
- volumes:
- - /local/file/path:/data
- restart: unless-stopped
-```
-Variable | Description | Requirement
----|---|---
-BASE_URL | Redirect link for when people visit old/dead/non-existant link | **Required**
-IP_TO_LOCATION | "True"/"False" Whether or not you want to IP to Location feature (requires IP2Location.io account) | **Required**
-API_KEY | IP2Location.io API Key | **Required** *unless IP_TO_LOCATION is "False"*
+<h3 align="center">
+ Link shortener and IP logger
+</h3>
+
+<p align="center">
+ <a href="https://github.com/psf/black">
+ <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black">
+ </a>
+ <a href="https://makeapullrequest.com">
+ <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg">
+ </a>
+</p>
+
+# Overview
+### Create an account now at [link.pkrm.dev](https://link.pkrm.dev/signup)
+
+<br>
+
+LinkLogger is simple and public API to create redirect links and log IPs. Every visit to a registered short link will log the users IP address, location, user agent, browser, and OS before redirecting them to a specific URL.
+
+Just like Grabify, but unrestricted and with no real web UI.
+
+Feel free to submit an issue for any problems you experience or if you have an idea for a new feature. If you have a fix for anything, feel free to submit a pull request for review.
-## API Reference
+# API Reference
+View the API reference and try out the endpoints at the [docs page](https://link.pkrm.dev/api/docs)
-#### View the API reference and try out the endpoints at the [docs page](https://link.pkrm.dev/docs) \ No newline at end of file
+# Want to self-host?
+
+## Bare metal
+To run LinkLogger on bare metal, follow the steps below.
+
+*NOTE: For information on each configuration variable, look at the `Configuration` section of this page.
+
+1. Install Python and Pip
+2. Clone this repository
+3. Install the requirements with `pip install -r requirements.txt`
+4. Run the `linklogger.py` file
+5. Input information into the newly created `config.ini` file.
+6. Re-run the `linklogger.py` file.
+
+## Docker
+To run LinkLogger in Docker, use the [docker-compose.yaml](/docker-compose.yaml) as a template for the contianer.
+
+## Config
+Below are all of the configuration variables that are used within LinkLogger.
+
+Variable | Description | Requirement
+---|---|---
+BASE_URL | `URL`: Redirect URL for when people visit old, dead, or non-existant links | **Required**
+IP_TO_LOCATION | `BOOLEAN`: Whether or not you want toe IP to Location feature <br> *(requires IP2Location.io account)* | **Required**
+API_KEY | `KEY`: IP2Location.io API Key | **Required** *only if IP_TO_LOCATION is set to True* \ No newline at end of file