{"id":13409246,"url":"https://github.com/eggheads/eggdrop","last_synced_at":"2025-03-14T14:31:07.879Z","repository":{"id":1968921,"uuid":"44209137","full_name":"eggheads/eggdrop","owner":"eggheads","description":"The Eggdrop IRC Bot","archived":false,"fork":false,"pushed_at":"2024-09-08T18:47:11.000Z","size":29955,"stargazers_count":496,"open_issues_count":226,"forks_count":84,"subscribers_count":35,"default_branch":"develop","last_synced_at":"2024-09-09T15:52:30.641Z","etag":null,"topics":["bot","c","eggdrop","hacktoberfest","irc","python","tcl"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eggheads.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog.gz","contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":["https://www.digitalocean.com/?refcode=2b2e5ea689b2\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program","https://www.eggheads.org"]}},"created_at":"2015-10-13T22:26:59.000Z","updated_at":"2024-09-09T10:42:23.000Z","dependencies_parsed_at":"2023-02-19T10:30:43.941Z","dependency_job_id":"f76ca83f-b240-43d4-ba88-61c2d2cc7fc7","html_url":"https://github.com/eggheads/eggdrop","commit_stats":{"total_commits":3358,"total_committers":36,"mean_commits":93.27777777777777,"dds":0.8323406789755807,"last_synced_commit":"26ecf0921ee84c5bf61cb31014a75f02670b1af4"},"previous_names":[],"tags_count":71,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eggheads%2Feggdrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eggheads%2Feggdrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eggheads%2Feggdrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eggheads%2Feggdrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eggheads","download_url":"https://codeload.github.com/eggheads/eggdrop/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243593328,"owners_count":20316167,"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":["bot","c","eggdrop","hacktoberfest","irc","python","tcl"],"created_at":"2024-07-30T20:00:59.192Z","updated_at":"2025-03-14T14:31:06.535Z","avatar_url":"https://github.com/eggheads.png","language":"C","readme":"README\n\n  Please, at least SKIM this document before asking questions. In fact,\n  READ IT if you've never successfully set up an Eggdrop bot before.\n\nNOTICE\n\n  Make SURE that you select your +n (owner) users wisely. They have 100%\n  access to your bot and account. ONLY GIVE THIS POWER TO SOMEONE YOU\n  TRUST COMPLETELY!\n\nWHAT IS EGGDROP?\n\n  Eggdrop is the world's most popular Internet Relay Chat (IRC) bot; it\n  is freely distributable under the GNU General Public License (GPL).\n  Eggdrop is a feature-rich program designed to be easily used and\n  expanded upon by both novice and advanced IRC users on a variety of\n  hardware and software platforms.\n\n  An IRC bot is a program that sits on an IRC channel and performs\n  automated tasks while looking just like a normal user on the channel.\n  Some of these functions include protecting the channel from abuse,\n  allowing privileged users to gain op or voice status, logging channel\n  events, providing information, hosting games, etc.\n\n  One of the features that makes Eggdrop stand out from other bots is\n  module and Tcl and Python scripting support. With scripts and modules\n  you can make the bot perform almost any task you want. They can do\n  anything: from preventing floods to greeting users and banning\n  advertisers from channels.\n\n  You can also link multiple Eggdrop bots together to form a botnet.\n  This can allow bots to op each other securely, control floods\n  efficiently and even link channels across multiple IRC networks. It\n  also allows the Eggdrops share user lists, ban/exempt/invite lists,\n  and ignore lists with other bots if userfile sharing is enabled. This\n  allows users to have the same access on every bot on your botnet. It\n  also allows the bots to distribute tasks such as opping and banning\n  users. See doc/BOTNET for information on setting up a botnet.\n\n  Eggdrop is always being improved and adjusted because there are bugs\n  to be fixed and features to be added (if the users demand them and\n  they make actually sense). In fact, it existed for several years as\n  v0.7 - v0.9 before finally going 1.0. This version of Eggdrop is part\n  of the 1.9 tree. A valiant effort has been made to chase down and\n  destroy bugs.\n\n  This README file contains information about how to get Eggdrop,\n  command line options for Eggdrop, what you may need to do when\n  upgrading from older versions, a list of frequently asked questions,\n  how to set up a crontab, some boring legal stuff, some basics about\n  git usage and some channels where you might get help with Eggdrop.\n\nHOW TO GET EGGDROP\n\nThere are two official methods to download Eggdrop source code.\nAlternately, Eggdrop also comes as a docker image.\n\nFTP\n\n  The latest Eggdrop stable source code is always located at\n  https://geteggdrop.com. You can also download the current stable,\n  previous stable, and development snapshot at\n  https://ftp.eggheads.org/pub/eggdrop/source\n\nGit Development Snapshot\n\n  Eggdrop developers use git to manage the Eggdrop codebase for\n  development. If you are interested in trying out the VERY LATEST\n  updates to Eggdrop, you can use git to obtain most recent code from\n  the Eggheads repository. BE WARNED, the development branch of Eggdrop\n  is not to be considered stable and may (haha) contain significant bugs\n  still being worked on.\n\n  To obtain Eggdrop via the git repository (hosted by GitHub), you can\n  either clone the repository via git or download a development\n  snapshot.\n\n  To clone the repository, simply type:\n\n      git clone https://github.com/eggheads/eggdrop.git \n\n  Otherwise, you can download the development snapshot as a tar archive\n  from:\n\n    https://github.com/eggheads/eggdrop/archive/develop.tar.gz\n\nDocker\n\n  You can pull the official Eggdrop Docker image via:\n\n      docker pull eggdrop:latest\n\n  Additional Eggdrop Docker documentation can be found at\n  https://hub.docker.com/_/eggdrop\n\nSYSTEM PRE-REQUISITES\n\n  Before you can compile Eggdrop, Tcl must be installed on your system.\n  Many systems have Tcl installed on them by default (you can check by\n  trying the command \"tclsh\"; if you are given a '%' for a prompt, it\n  is, and you can type 'exit' to exit the Tcl shell. However, Eggdrop\n  also requires the Tcl development header files to be installed. They\n  can often be installed via an OS package manager, usually called\n  something similar to 'tcl-dev' for the package name. You can also\n  download Tcl source from\n  https://www.tcl.tk/software/tcltk/download.html.\n\n  Eggdrop also requires openssl (and its development headers) in order\n  to enable SSL/TLS protection of network data. The header files are\n  often called something similar to 'libssl-dev'. While not advised,\n  this requirement can be removed by compiling using\n  ./configure --disable-tls, but you will not be able to connect to\n  TLS-protected IRC servers nor utilize secure botnet communication.\n\nMINIMUM REQUIREMENTS\n\nSome components of Eggdrop relies on a variety of third-party libraries,\ndocumented here.\n\n  -----------------------------------------------------------------------\n  Functionality                   Package             Minimum Version\n  ------------------------------- ------------------- -------------------\n  Tcl interpreter (required)      Tcl Dev Library     8.5.0\n\n  Secure communication            OpenSSL             0.9.8\n\n  Python module                   Python              3.8.0\n\n  Compression module              zlib                Any\n  -----------------------------------------------------------------------\n\nQUICK STARTUP\n\n  Please see the Install file after you finish reading this file.\n\nUPGRADING\n\n  The upgrade process for Eggdrop is very simple, simply download the\n  new source code and repeat the compile process. You will want to read\n  the NEWS for any new configuration file settings you want to add.\n  Please see Upgrading for full details.\n\nCOMMAND LINE\n\n  Eggdrop has some command line options - not many, because most things\n  should be defined through the config file. However, sometimes you may\n  want to start up the bot in a different mode and the command line\n  options let you do that. Basically, the command line for Eggdrop is:\n\n      ./eggdrop [options] [config-file]\n\n  The options available are:\n\n    -t: Don't background, use terminal. Your console will drop into an\n\n        interactive partyline session, similar to a DCC chat with the\n        bot. This is useful for troubleshooting connection issues with\n        the bot.\n\n    -c: Don't background, show channel info. Every 10 seconds your screen\n\n        will clear and you will see the current channel status, sort of\n        like \"top\".\n\n    -m: Create userfile. If you don't have a userfile, this will make Eggdrop\n\n        create one and give owner status to the first person that\n        introduces himself or herself to it. You'll need to do this when\n        you first set up your bot.\n\n    -h: Show help, then quit.\n\n    -v: Show version info, then quit.\n\n  Most people never use any of the options except -m and you usually\n  only need to use that once.\n\nAUTO-STARTING EGGDROP\n\nSystems go down from time to time, taking your Eggdrop along with it.\nYou may not be not around to restart it manually, so you can instead use\nfeatures of the operating system to automatically restart Eggdrop should\nit quit for any reason. Eggdrop comes with an autobotchk shell script\nthat can create either a systemd or crontab entry. The systemd option\nwill monitor your Eggdrop and a) start it when the machine boots and b)\nrestart the Eggdrop if it crashes for any reason. The (older) crontab\noption will check (by default) every 10 minutes to see if your Eggdrop\nis still running, and attempt to restart it if it is not.\n\n  To auto-generate a systemd job, from the Eggdrop install directory,\n  simply run:\n\n      ./scripts/autobotchk \u003cEggdrop config file\u003e -systemd\n\n  To auto-geneerate a script to check Eggdrop's status and run it via a\n  crontab entry, simply run:\n\n      ./scripts/autobotchk \u003cEggdrop config file\u003e\n\n  This will crontab your bot using the default setup. If you want a list\n  of autobotchk options, type './autobotchk'. A crontab example with\n  options would be:\n\n      ./scripts/autobotchk \u003cEggdrop config file\u003e -noemail -5\n\n  This would setup crontab to run the botchk every 5 minutes and not\n  send you an email saying that it restarted your bot.\n\nDOCUMENTATION\n\n  We're trying to keep the documentation up to date. If you feel that\n  anything is missing here or that anything should be added, etc, please\n  create an issue, or better yet a pull request, at\n  https://www.github.com/eggheads/eggdrop Thank you!\n\nOBTAINING HELP\n\n  You can obtain help with Eggdrop in the following IRC channels:\n\n    -   Libera Chat - #eggdrop (official channel), #eggheads\n        (development discussion)\n    -   DALnet - #eggdrop\n    -   EFnet - #egghelp\n    -   IRCnet - #eggdrop\n    -   QuakeNet - #eggdrop.support\n    -   Undernet - #eggdrop\n\n  If you plan to ask questions in any of the above channels, you should\n  be familiar with and follow IRC etiquette:\n\n    -   Don't type using CAPITAL letters, colors or bold.\n    -   Don't use \"!\" and \"?\" excessively.\n    -   Don't /msg people without their permission.\n    -   Don't repeat or paste more than 4 lines of text to the channel.\n    -   Don't ask to ask- just state your question, along with any\n        relevant details and error messages\n\nCopyright (C) 1997 Robey Pointer Copyright (C) 1999 - 2024 Eggheads\nDevelopment Team\n","funding_links":["https://www.digitalocean.com/?refcode=2b2e5ea689b2\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program","https://www.eggheads.org"],"categories":["C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feggheads%2Feggdrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feggheads%2Feggdrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feggheads%2Feggdrop/lists"}