{"id":21041017,"url":"https://github.com/chfoo/irclogger-mirror","last_synced_at":"2025-06-14T02:05:52.378Z","repository":{"id":23060853,"uuid":"26414236","full_name":"chfoo/irclogger-mirror","owner":"chfoo","description":"Unofficial mirror of the irclogger project","archived":false,"fork":false,"pushed_at":"2014-12-04T04:04:49.000Z","size":432,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T21:24:18.966Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://colas.nahaboo.net/Software/IrcLogger","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chfoo.png","metadata":{"files":{"readme":"README.txt","changelog":"HISTORY.txt","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-11-10T00:17:28.000Z","updated_at":"2014-12-04T04:04:49.000Z","dependencies_parsed_at":"2022-08-21T18:50:30.491Z","dependency_job_id":null,"html_url":"https://github.com/chfoo/irclogger-mirror","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/chfoo/irclogger-mirror","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Firclogger-mirror","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Firclogger-mirror/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Firclogger-mirror/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Firclogger-mirror/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chfoo","download_url":"https://codeload.github.com/chfoo/irclogger-mirror/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chfoo%2Firclogger-mirror/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259747226,"owners_count":22905311,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T13:49:57.609Z","updated_at":"2025-06-14T02:05:52.354Z","avatar_url":"https://github.com/chfoo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Irclogger installation\n======================\nIRC Logger python bot, http://colas.nahaboo.net/Software/IrcLogger\n\nYou will need to define 3 places:\n   BIN (dir) where to put the CGI web executables and config file\n   LOG (dir) where the logs will be stored (ideally out of the web space)\n\t     and optional html+css style files\n   PASS (file) where is the apache passwords file for the channels\nand the URL where BIN will be visible from the web\nand optionally the CHANNEL to log on startup.\n\nIt is developed on linux, should work on all unixes (maybe with the various\nutilities such as grep, sed,... in their GNU variants), may work on cygwin.\n\nQuick Install:\n==============\nuncompress irclogger somewhere (/usr/local/irclogger is the default dir, so \ngo to /usr/local, and uncompress the distribution there)\ngo to this dir\nrun: ./install BIN LOG PASS URL CHANNEL\nfollow the instructions.\n\nYou need to have agrep installed on your system (http://www.tgries.de/agrep/)\nIt should work with any 2.x python.\n\nPS: to find quickly where irclogger has been installed on a machine, do\na \"locate\" to find files irclogger.log (for LOG) and irclogger.conf (for BIN)\n\nUpgrade:\n========\nDue to the installation using symbolic links, upgrade is a breeze:\n  [1] uncompress the distribution where you installed it (default: /usr/local)\n  [2] check the HISTORY for other manual upgrade steps, if any\n  [3] if the HISTORY says that \"irclogger\" changed, kill its running \n      instances, you can find them by: \n\t   ps awx|grep 'python.*[i]rclogger'\n      If you run it via an irclogger-run based script, they will be restarted\n      automatically in 45s\n\nNote: major versions (1.4, 1.5...) means that the irclogger python bot has\nchanged and that you should restart it. Minor versions (1.5a, 1.5b...) means\nthat only the doc or the cgi scripts have changed, so only step [1] should be\nperformed. Version of irclogger is specified at the head of irclogger and will\nnever be minor, version of the rest is in the HISTORY file.\n\nDetails:\n========\n\nirclogger.conf\n--------------\nin the BIN directory of the web server\nContains the path of the irclogger main LOG dir (logsdir). Each subdir in it\nindicates that a channel of this name is logged.\nsyntax is bash variable declarations, and can be:\n\nlogsdir=/var/log/irclogger\npassfile=/var/www/passwds/irclogger-passwds\nprivate_image=\"${private_image:-\u003cimg src='http://colaz.net/qbullets/private.gif' width=11 height=10 alt='Password-protected log'\u003e}\"\ntop=URL where the upmost \"back\" link will bring the user\n\nIn the irclogger_dir LOG, one can put files:\n   style.css  that will be included in all html pages\n   message.html will be included at the top of the html index page\n\nLOG must be read\u0026writable by the UID you run the irclogger daemon\nand readable by the web server UID\nYou should do in it:\necho 'deny from all' \u003e.htaccess\n\nLogs are in LOG/CHANNEL/YYYY-MM-DD,Day.log\nLogs can be passord-protected by users from the web interface, except\n     if a file named \"PUBLIC\" exists in its dir. Users cannot remove\n     the protection (A channel log is protected if a user of the name of the\n     channel exists in PASS)\n\nIn the Logs dir, you can create a file CHANNELS.deny to limit the logger to\nlog only the channel names (without the #, space-separated on one line) in it,\nas some IRC servers limits the number of channels a single bot can monitor,\noften 5.\n\npassfile (aka PASS) must be web-server writable htpasswd file, and must exist\n\nLogs can be compressed/decompressed at anytime via gzip. listing and searching\nwill work transparently with compressed files. If any file is compressed, the\nsearch program will create a expansed mirror of all the logs in LOG/.exp that\nshould be created writable by the web server UID on installation\n\nto run:\n======\n\ncopy irclogger-run in /usr/local/bin, edit it, and run it once at startup,\nvia start-stop-daemon for instance or a @reboot line in a crontab. \nCopy it under as many copies as you want to run separate irclogger bots.\n\nA sample init.d-irclogger-sample is provided that you can copy as \n/etc/init.d/irclogger (red hat version)\n\nOn web server:\n==============\n\nWith a web ScriptAlias dir BIN where you have \"AllowOverride All\" \npermissions, do:\n\nthen:\n  S=/usr/local/irclogger\n  cd $S\n  cp htaccess.sample $BIN/.htaccess\n  ln -fs $S/irclogger_* $S/nph-irclogger_reset_auth $BIN\n\n  create a $BIN/irclogger.conf\n\n  cd $BIN\n  for i in logs password log log_search \n  do ln -s irclogger_${i} irclogger_${i}_a; done\n  # Edit first line of $DIR/.htaccess to reflect $PASS value\n\n  . irclogger.conf; touch $PASS;chmod a+rw $PASS\n\nOn your web pages, Call by something like:\n\u003ca href='/cgi-bin/irclogger_logs/XXX'\u003eIRC log for channel #XXX\u003c/a\u003e\n\n-----------------------------------------------------------------------------\n\nImplementation:\n===============\n\nThis system is made of scripts running under linux and apache. It should run\non any similar system, such as cygwin on windows systems, but needs the GNU\nversion of unix tools (date, grep, sed...), not the old SYSV or BSD ones.\n\n\nirclogger [python]\n    Uses ircAsync.py. This script runs the robot\n    which connects to channels and dumps logs in text form (MIRC format)\n    in $LOG/logs dir\n    The rest are shell (bash) scripts.\n\nirclogger-run [bash]\n    Is a sample sript to see how to run irclogger. It provides parameters,\n    and restarts it on termnination (ircloggers quits in case of\n    deconnection)\n\nirclogger_tohtml [bash]\n    irclogger_tohtml channel date selected \u003c log\n    \n    Pretty-prints the channel log. If the channel log dir contains a file named\n    \"style.css\", appends it to the current style (found in the parent dir).\n    Possible classes of elements are:\n        tr.even  the even rows\n        tr.odd   the odd rows\n        tr.sep   the separator rows (no messages for more than an hour)\n        tr.irc   the control messages\n        tr.selected the selection\n    selected can be set to a line number to highlight\n    If a style.css file is defined, it replaces the one built-in in \n    irclogger_tohtml in var DEFSTYLE\n\nirclogger_totml [bash]\n    irclogger_totml channel date selected \u003c log\n    Pretty-prints in a text form incluable in Wikis using the TML markup\n    (Topic Markup Language), see http://foswiki.org/System/TextFormattingRules\n    TML is used by Foswiki and TWiki\n\nirclogger_totext [bash]\n    irclogger_totext channel date selected \u003c log\n    prints only the contents without control messages and nicknames\n    useful for getting meeting notes by a single scribe + correcters\n\nirclogger_logs [bash, cgi]\n    irclogger_logs/channel\n    lists all available days in channel\n    if a file message.html exists in the log dir it will be included at top\n\nirclogger_log [bash, cgi]\n    irclogger_log/channel?date=date\u0026raw=on%sel=linenum\n\nirclogger_log_search [bash, cgi]\n    irclogger_log_search/channel...\n\nirclogger_log_style [bash, cgi]\n    irclogger_log_style channel\n    generates a CSS for a channel with a color per active name\n\nnph-irclogger_reset_auth [bash, cgi]\n    used to reset the apache authentication to allow login on another\n    protected channel\n\nirclogger_password [bash, cgi]\n    used to change/set passwords in the PASS file\n\nirclogger_common [bash]\n    a library of common functions used by the scripts\n\nstyle.css [css]\n    a sample CSS file to use to have a nicer look\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchfoo%2Firclogger-mirror","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchfoo%2Firclogger-mirror","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchfoo%2Firclogger-mirror/lists"}