📖 OSRS Chatlogger Wiki
📚 Contents
Welcome to the OSRS Preservation Project
OSRS Chatlogger is a powerful tool for managing, searching, and monitoring your Old School RuneScape chat logs.
📢 Version 3.0 Released!
Version 3.0 with Discord Bot Dashboard, Embed Builder, and more!
Quick Links
🚀 Getting Started
System Requirements
- Python 3.8 or higher
- 500MB free disk space
- Any modern web browser
Installation
- Download and extract OSRS Chatlogger
- Install Python from python.org
- Run the appropriate start script for your OS
- Open
http://localhost:5000in your browser
Start Scripts
Windows: Double-click start_windows.bat
Mac: Run ./start_mac.sh
Linux: Run ./start_linux.sh
First Login
Default admin credentials:
Username: admin
Password: admin
⚠️ Change this password immediately after first login!
⭐ Features
📤 Multi-Format Import
Upload chat logs in TXT, PDF, DOC, DOCX, CSV, and JSON formats.
🔍 Full-Text Search
Fast search using SQLite FTS5. Filter by username, keyword, date range.
📡 Live Monitoring
Real-time chat log monitoring with auto-refresh and user tracking.
👥 User Tracking
Automatic user database from chat logs. Add favorites, notes, and track Ironman status.
🎮 Ironman Support
Full support for all Ironman modes with automatic detection.
💬 Community Chat
Built-in chat system for registered users.
🎮 Ironman Icons
OSRS Chatlogger supports all Ironman modes with their official icons.
Ironman
Standard self-sufficient mode
Hardcore Ironman
One life challenge mode
Ultimate Ironman
No banking allowed
Group Ironman
Team-based ironman
How Icons Work
- Icons are auto-detected from chat log format
- Manual assignment available in user profile
- Icons display in search results and user lists
📱 Device Support
OSRS Chatlogger works on all modern devices with a responsive design.
🖥️ Desktop
Full experience with all features. Windows, Mac, Linux.
📱 Mobile
Responsive design for iOS and Android browsers.
📟 Tablet
Optimized layout for iPad and Android tablets.
🌐 Browsers
Chrome, Firefox, Safari, Edge supported.
📋 Changelog
Version 3.0
December 2025Discord Bot Dashboard & Automation
- Complete Discord Bot Dashboard with web management
- Embed Builder with live preview and multi-embed support
- Reaction Roles system with buttons, dropdowns, and reactions
- Advanced Ticketing System with ticket types and transcripts
- Leveling System with role rewards and leaderboards
- Welcome & Goodbye messages with custom embeds
- Auto Moderator with word filters and spam protection
- Custom Commands with variables and cooldowns
- Logging system for message edits, deletes, and moderation
- Server sync for channels, roles, and emojis
- Google OAuth integration for login
- Live chat monitor with Syncthing integration
Version 2.0
December 2025Complete Forum Overhaul
- Rich text editor with BBCode support
- Image uploads and auto-save drafts
- Multi-quote and @mentions system
- Thread prefixes, tags, and solution marking
- Post voting with animations
- Thread subscriptions and notifications
- Post reactions (👍 ❤️ 😂 😮 😢 🎉)
- Forum statistics dashboard
- Thread polls system
- Activity feed and achievements
- Enhanced admin panels with quick links
Version 1.0.2 Beta
December 2025Admin Panel Overhaul & Performance
- Complete Admin Settings rewrite with 7 tabs
- Wiki performance optimization (2 min → 5 sec load)
- Site & Chat settings configuration
- SMTP email configuration with test
- Database export functionality
- VPS optimization for 1GB RAM servers
ℹ️ About
OSRS Chatlogger
Version 3.0
A web application for Old School RuneScape players to manage, search, and archive chat logs.
Key Features
- Multi-format import (TXT, PDF, DOC, CSV, JSON)
- Full-text search with SQLite FTS5
- Real-time file monitoring
- User tracking with favorites
- Ironman icon support
- Multi-user authentication
- Remote access support
- OSRS-themed responsive design
Created by NullBot
© 2025 All Rights Reserved.
📜 Terms of Service
Last Updated: December 17, 2025
1. Acceptance of Terms
By accessing or using OSRS Chatlogger, you agree to be bound by these Terms of Service.
2. Prohibited Activities
Doxxing, stalking, harassment, and illegal content are strictly prohibited and may result in permanent ban and legal action.
3. Limitation of Liability
The Service is provided AS IS. The operator is not liable for user-generated content or third-party actions.
📋 Community Rules
Violations may result in permanent ban or legal action.
Rule 1: No Doxxing
Publishing private information about individuals is prohibited.
Rule 2: No Stalking
Using this platform to track or harass individuals is prohibited.
Rule 3: No Illegal Content
Content promoting illegal activities is prohibited.
Rule 4: Respect Privacy
Consider others privacy when uploading chat logs.
🔒 Privacy Policy
Data We Collect
Account info, chat logs you upload, IP addresses, and forum activity.
Law Enforcement
We cooperate with law enforcement and may disclose data for valid legal requests.
Your Responsibility
You are responsible for content you upload including third-party information.
🖥️ Self-Hosting Guidelines
🚫 Self-Hosting Requires Prior Approval
Self-hosting of the OSRS Preservation Project is not openly permitted. If you wish to host your own instance, you must first receive explicit approval from NullBot (Owner of the program and website).
📋 How to Request Approval
If you have a legitimate reason to self-host, please contact NullBot through one of the following methods:
💬 Discord (Preferred)
Join the official Discord and contact NullBot directly:
📧 Contact Form
Use the Contact page on this website.
⚠️ Why Self-Hosting is Restricted
The OSRS Preservation Project has implemented these restrictions for the following reasons:
🛡️ Abuse Prevention
Unrestricted self-hosting has previously led to abuse of the software, including misuse of features, harassment facilitation, and violations of community trust. Requiring approval allows us to vet potential hosts and ensure responsible use.
💰 Monetization Restrictions
The OSRS Preservation Project must NOT be monetized in any way. This includes charging users for access, selling the software, running ads, accepting donations for hosting, or any other form of financial gain. Approval ensures compliance with this policy.
🔒 Not Open Source
The OSRS Preservation Project is proprietary software and is not open source. The source code is not publicly available, and redistribution or modification without explicit permission is prohibited. This protects the project's assets, reputation, and ensures quality control.
📜 If Approved
If your request is approved, you will be required to:
- Provide visible credit to NullBot as the original creator
- Include a backlink to https://osrschatlogger.com
- Link to the official Discord community
- Agree to non-commercial use only
- Not modify or redistribute the source code
- Comply with any additional terms specified during approval
🤖 Bot Dashboard Notice
The Bot Dashboard panel included in OSRS Chatlogger is configured specifically for the official OSRS Chatlogger Discord server and the Wise Old Bot.
If approved for self-hosting and you want bot dashboard functionality, you will need to:
- Create and configure your own Discord bot
- Update the bot credentials and settings
- The existing dashboard will NOT work with the official bot
🙏 Thank You
These restrictions exist to protect the OSRS Preservation Project and ensure it remains a trusted, high-quality tool for the RuneScape community. We appreciate your understanding and cooperation.
If you simply want to use the service, you're welcome to use the official instance at osrschatlogger.com — no approval needed!