Skip to content

Repository files navigation

Shadow Perl IRC Bot

screenshot

What is shadow?

shadow is a modular IRC bot written in Perl by Aaron Blakely, it's goal is to be a stable IRC bot with cool features.

Where can I get support for shadow?

  • Try irc.ephasic.org #shadow
  • /msg bot help

Installing

Installing Shadow is very simple thanks to our dependency installer, just run installdepends.pl and let the script prepare your environment. See below for specific instructions related to your operating system.

Docker

sudo docker -d -p 1337:1337 -e IRC_NICK=MyBot --name shadow ab3800/shadow

See shadow-docker for more information about configuring the bot with environment variables.

Linux

To install on debian/ubuntu systems you will need to following packages: sudo apt-get install libjson-perl libxml-libxml-perl libxml-feed-perl build-essential

OS X

I've only tested on OS X 10.4 Tiger on my iMac G4. To require the dependencies for the RSS module you will need to install brew and run: brew install libxml2

Windows

To install on Windows, use Strawberry Perl and Git-bash for the shell.

  • Run installdepends.bat
  • Edit and rename your configuration (etc/shadow.conf.example -> etc/shadow.conf)
  • Run shadow.bat

Standard Modules

ModuleDescription
WebAdmin.pmWeb Administration Panel
Aliases.pmCustom channel triggered responses
Commands.pmProvides list of channel commands
RSS.pmRSS Feed Reader
AutoID.pmAutomatically authenticate with network services
ChanOP.pmBasic channel management commands
Uptime.pmBasic module which gives *nix uptime info (requires neofetch for Windows)
Autojoin.pmAutomatically join channels on connect
URLIdentifier.pmAutomatically fetches the title of a URL
BotStats.pm[Linux/Windows] Returns information about the bot, like memory usage
Fortune.pm[*nix/Mac] Wrapper for the fortune command
Weather.pmFetches weather information for a given location
Welcome.pmGreets users when they enter a channel
MacSysInfo.pmSystem information using system_profiler
Neofetch.pmSystem information using neofetch
Lolcat.pmlolcat for IRC (kinda)
Ignore.pmAllows bot admins to make the bot ignore users
MSLParser.pm(Alpha) mIRC Scripting Language parser

About

A modular and event driven IRC bot written in Perl

Topics

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages