ezosresyek/znc-nicktrace

A ZNC module to track users

znc-nicktrace

A ZNC module to track users

Table of Contents

• Requirements
• Installation
• Loading
• Commands
  • Aggregate Commands
  • trace Commands
  • Moderation History Commands
  • User Info Commands
  • Modify Data Commands
  • Other Commands
• Configuration Variables
• Contact

Requirements

• ZNC
• Python 3
• modpython
• python3-requests
• sqlite3

Installation

To install aka, place aka.py in your ZNC modules folder

Loading

aka must be loaded on each network you wish to use it on /msg *status loadmod aka

Commands

Aggregate Commands

all nick <nick> Perform complete lookup on nick (trace, channels, offenses, geoip, seen)

all host <host> Perform complete lookup on host (trace, channels, offenses, geoip, seen)

User Lookup Commands

trace nick <nick> Show nick change and host history for given nick

trace host <host> Show nick change and host history for given host

trace lasthost <nick Show host history for last known host of given nick

userinfo <nick> Show last known information for given nick

userinfo <host> Show last known information for given nick

sharedchans nicks <nick1> <nick2> ... <nick#> Show common channels between a list of nicks

sharedchans hosts <host1> <host2> ... <host#> Show common channels between a list of hosts

intersect nicks <#channel1> <#channel2> ... <#channel#> Display nicks common to a list of channels

intersect hosts <#channel1> <#channel2> ... <#channel#> Display hosts common to a list of channels

channels nick <nick> Get all channels a nick has been seen in

channels host <host> Get all channels a host has been seen in

Moderation History Commands

offenses nick <nick> Display kick/ban/quiet history for nick

offenses host <host> Display kick/ban/quiet history for host

offenses in nick <#channel> <nick> Display kick/ban/quiet history for nick in channel

offenses in host <#channel> <host> Display kick/ban/quiet history for host in channel

User Info Commands

seen nick <nick> Display last time nick was seen speaking globally

seen host <host> Display last time host was seen speaking globally

seen in nick <#channel> <nick> Display last time nick was seen speaking in channel

seen in host <#channel> <host> Display last time host was seen speaking in channel

geoip <host> Geolocates the given host

geoip <nick> Geolocates a user by nick

Modify Data Commands

process all Processes all channels

process channel <#channel> Processes a given channel

process nick <nick> Processes a given nick

add <nick> <host> Manually add a nick/host entry to the database

rawquery <query> Run raw sqlite query

dbimport <filename.db> Imports an entire aka.db database in moddata folder for network (both users must be using latest aka version)

import <url> Imports user data to DB from valid JSON file url

export nick <nick> Exports nick data to JSON file

export host <host> Exports host data to JSON file

Other Commands

about Display information about aka

version Get current module version

stats Print nick and host stats for the network

update Updates aka to the newest version

help Print help from the module

Configuration

Commands

getconfig Print current network configuration

config <variable> <value> Set configuration variables

Variables

• DEBUG_MODE (True/False) Display raw output (False)
• NOTIFY_ON_JOIN (True/False) Automatically run trace nick when a user joins a channel (False)
• NOTIFY_ON_JOIN_TIMEOUT (int: seconds) How long to wait before sending notification again for same user (300)
• NOTIFY_DEFAULT_MODE (nick/host) Whether to use nick or host for on join trace all (host)
• NOTIFY_ON_MODE (True/False) Automatically be notified when channel modes are changed (False)
• NOTIFY_ON_MODERATED (True/False) Be notified when a user is banned, quieted, or kicked (False)
• PROCESS_CHANNEL_ON_JOIN (True/False) Process all users in a channel on join (False)
• PROCESS_CHANNELS_ON_LOAD (True/False) Process users in all channels when module is loaded (False)
• WHO_USER_ON_JOIN (True/False) Sends a WHO when a user joins a channel (False)
• TRACK_SEEN (True/False) Whether or not to track the last seen status of users (True)

Contact

Issues/bugs should be submitted on the GitHub issues page.

For assistance, please PM Evan (Evan) on freenode or Snoonet.