https://github.com/skidoodle/ncore-stats
📈 Profile activity tracker for the largest Hungarian BitTorrent tracker, nCore.
https://github.com/skidoodle/ncore-stats
ncore ncore-stats
Last synced: 6 months ago
JSON representation
📈 Profile activity tracker for the largest Hungarian BitTorrent tracker, nCore.
- Host: GitHub
- URL: https://github.com/skidoodle/ncore-stats
- Owner: skidoodle
- License: gpl-3.0
- Created: 2024-10-08T23:12:40.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-22T13:10:55.000Z (8 months ago)
- Last Synced: 2025-11-22T15:09:05.084Z (8 months ago)
- Topics: ncore, ncore-stats
- Language: Go
- Homepage: https://nc.albert.lol
- Size: 136 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# nCore Profile Tracker
A simple Go project to scrape and track profile statistics (rank, upload, download, points) on nCore, the largest Hungarian BitTorrent tracker. The stats are stored in a SQLite database and displayed on a basic web interface.
## Features
- Scrapes and logs profile stats from nCore for multiple users.
- Serves a simple HTML dashboard to display the latest data and historical charts.
- Provides a JSON API to fetch historical profile data.
- Stores all data persistently in a SQLite database.
- Automatically updates data every 24 hours.
## Setup
1. **Clone the repo:**
```bash
git clone https://github.com/skidoodle/ncore-stats
cd ncore-stats
```
2. **Create a `.env` file with your nCore credentials:**
```ini
NICK=your_nick
PASS=your_password
```
3. **Add Users to Track**
You can add users via the `--add-user` command-line flag. Run this command for each user you want to track.
The format is a single string: `'DisplayName,ProfileID'`.
```bash
# Example for running from source
go run . --add-user 'Alice,69'
go run . --add-user 'Bob,420'
```
> **How to find a Profile ID?**
> Navigate to a user's profile on nCore. The URL will be `https://ncore.pro/profile.php?id=12345`. The `ProfileID` is the number at the end.
### How to obtain `NICK` and `PASS`
- Open the developer tools in your browser (F12), go to the "Network" tab.
- Log in to nCore using "lower security" mode.
- Find the `login.php` request in the network activity.
- In the response headers, locate the `Set-Cookie` header, which will contain `nick=` and `pass=` values.
- Copy those values and add them to your `.env` file.
## Running with Docker Compose
1. **Create the following `docker-compose.yml` file:**
```yaml
services:
ncore-stats:
image: ghcr.io/skidoodle/ncore-stats:main
container_name: ncore-stats
restart: unless-stopped
ports:
- "3000:3000"
volumes:
- ./data:/app/data
environment:
- NICK=${NICK}
- PASS=${PASS}
```
2. **Add Users using Docker**
When the container is already running, you can use `docker exec`:
```bash
# The executable inside the container is named 'ncore-stats'
docker exec ncore-stats ./ncore-stats --add-user 'Charlie,1337'
```
3. **Run the Docker Compose setup:**
Once you have added your users, start the service.
```bash
docker compose up -d
```
4. Open `http://localhost:3000` to view your stats.
### Updating
To pull the latest image and restart the service:
```bash
docker compose pull
docker compose up -d
```