README.md

adnumaZ

---

adnumaZ - your best torrent tracker

📝 Table of Contents

• About
• Getting Started
• Deployment
• Built Using
• Authors
• Acknowledgments

🧐 About

AdnumaZ gives you opportunity easily to share torrent files with friends, comment their work using P2P connection.

🏁 Getting Started

Register and Login pages

Scaffolded register and login pages

Admin role 

Custom profile custom image, username

Home controller

Index

The most recent 5 torrents

Privacy policy, security, disclaimer

Inform website visitors for our policies

Torrents controller

Upload

Enter torrent info - Title, Description, image

Saved in database with custom name avoiding privacy issues
Utilizes BencodeNET to parse .torrent files and collect data such as size, number of files etc.

Download

Downloading the torrent file from the server file system

Changing the custom name to the actual torrent name

Favourite

Visualizing the favourited torrents from the current user

All

Torrent info - Title, uploader, size, seeders, peers, upload date
Seeders and peers are retrieved from the tracker REST API

Pagination

Custom routing

By Id

Actions - Download, Edit, Favourite, Comment torrent, Answering comments, Delete comments

Admin Actions - Edit, Approve torrent, Delete comments

Torrent info - Title, description, image, uploader, size, seeders, peers, upload date

Torrent comments- Title, description, image, uploader, size, seeders, peers, upload date

Approve - REST service - ADMIN ONLY

Approve torrent with jQuery post request

Waiting approval torrents - API controller - ADMIN ONLY

Sending post request to the server, marking torrent as approved

Comments controller

Create

Asigning comment to the torrent and the user

Delete

Marking comment as deleted

Users controller

By Id

User profile information - uploaded GBs, downloaded GBs, favourited torrents, role, created on

All registered users - ADMIN ONLY

Showing registered users

Ban - ADMIN ONLY

Banning user, reason

Banned users - ADMIN ONLY

All the banned users

Dashboard controller - ADMIN ONLY

Site info banned users, torrents, waiting approval count, total downloaded/uploaded GBs

Most recent comments, opportunity to delete them

Error controller

Custom 404 error page

Dynamic status codes page, with easter eggs 🥚

Dark mode

The design adapts dynamically to the system light or dark mode preferences
For all the hackers out there

🚀 Deployment

To start the project in development mode, run in the project directory:

$ docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

To start in production mode run:

$ docker-compose -f docker-compose.yml -f docker-compose.prod.yml up

⛏️ Built Using

• ASP.NET 5.0
• Visual Studio 2022
• Entity Framework Core 5.0
• Sql Server
• AutoMapper
• Bootstrap
• Particles.js
• BencodeNET
• Bittorrent-tracker
• Moment.js
• Cloudinary
• Google reCaptcha v3

✍️ Authors

• @iwanmitowski - Idea & Initial work
• @kaykayehnn - Initial work & Deployment

🎉 Acknowledgements

• Knowledge - Nikolay Kostov, Stoyan Shopov
• Inspiration - Zamunda
• All the youtube and stackoverflow guys ❤️