538
edits
Robonaut: Difference between revisions
From London Hackspace Wiki
replacement-services
(replacement-services) |
|||
| (36 intermediate revisions by 14 users not shown) | |||
| Line 1: | Line 1: | ||
'''[ | '''[https://github.com/londonhackspace/irccat IRCCat]''' is running on [[Equipment/Blanton#replacement-services|replacement-services]], to help link [[IRC]] to things happening in the space. The documentation below reflects the refreshed instance on [[Equipment/Blanton#replacement-services|replacement-services]]. | ||
== Contributing commands == | |||
== | During the migration to [[Equipment/Blanton#replacement-services|replacement-services]] we decided to overhaul the command system to make it more flexible and maintainable. We have introduced '''breaking''' changes, so it is important to upgrade your scripts. | ||
=== Persistent commands === | |||
We (the maintainers) of Robonaut maintain a supervised set of persistent commands on [https://github.com/londonhackspace/irccat-commands irccat-commands]. If one wants to add a command to the persistent set of commands, one would need to fork this repository and issue a pull request so we can safeguard the quality of essential and commonly used commands. Each revision will have to go through this process. | |||
=== Contributed commands === | |||
Users can create commands for Robonaut in the <code>/opt/irccat/irccat-commands-contrib</code> directory. No guarantee will be provided on the availability of these commands, and if the system needs to be migrated in the future, we will potentially discard the commands in this folder. This would be a great location for temporary and/or fun commands, or to test your own commands before committing them to the main command set. | |||
=== Write access === | |||
One of the major changes to Robonaut compared to the old instance running on babbage is that write access to the persistent commands directory is prohibited, and that all data should be written to <code>/opt/irccat/irccat-data</code>. While it would also be possible to write to <code>/opt/irccat/irccat-commands-contrib</code>, this would be a very bad idea since this would prevent you from promoting your command to a persistent command. All commands writing outside of the <code>/opt/irccat/irccat-data</code> will be rejected, as well as commands which don't perform proper input filtering and thus offer an opportunity to write outside this directory. | |||
== Robonaut Commands == | == Robonaut Commands == | ||
| Line 16: | Line 24: | ||
=== Really useful commands === | === Really useful commands === | ||
*acnode - Query current usage of a tool and it's status. Current tools are | |||
** laser - Silvertail A0 lasercutter | |||
** 3in1 - 3 in 1 lathe | |||
** lulzbot - Lulzbot 3d printer | |||
** biolab - BioHacking lab | |||
** tig - Tig welder | |||
*board - Change message on the message board, syntax ?board[ message]. An empty message will clear the board. | *board - Change message on the message board, syntax ?board[ message]. An empty message will clear the board. | ||
*board2 - Changes the message on the [[Project:BigClock|Big Clock]] above the | *board2 - Changes the message on the [[Project:BigClock|Big Clock]] above the front entrance. Limited to about 5 characters a line. syntax as above. | ||
*sixteen - Changes the message on the [[Orange_led_strips|Sixteen Segment display]], n.b. only 6 characters. | |||
*commands - robonaut will PM you a list of all available commands. | *commands - robonaut will PM you a list of all available commands. | ||
*laser - current laser status. To change status ?laser <message> | *laser - current laser status. To change status ?laser <message> | ||
*makerbot - current makerbot status. To change status ?makerbot <message> | *makerbot - current makerbot status. To change status ?makerbot <message> | ||
*subscribers - Current number of paying members of London Hackspace. Useful for updating the topic in the channel. | *subscribers - Current number of paying members of London Hackspace. Useful for updating the topic in the channel. | ||
*netleft - says how much bandiwdth we have left for our internets | |||
=== Not so useful commands === | === Not so useful commands === | ||
| Line 30: | Line 47: | ||
*beacon - a symlink to beacons. | *beacon - a symlink to beacons. | ||
*beacons - Flashes lights within the space to attract attention. | *beacons - Flashes lights within the space to attract attention. | ||
*bikes - Tells you how many Boris bikes are available near the space | |||
*boris - Alias of bikes | |||
*cancer - simply prints hi..., as people who abuse the bot are the cancer that's killing IRC - marked for possible archiving. | *cancer - simply prints hi..., as people who abuse the bot are the cancer that's killing IRC - marked for possible archiving. | ||
*cc - generates credit card numbers that pass the MOD 10 check (Luhn formula). Pass [visa|mastercard|amex] for certain formats. | *cc - generates credit card numbers that pass the MOD 10 check (Luhn formula). Pass [visa|mastercard|amex] for certain formats. | ||
| Line 41: | Line 60: | ||
*donate - points to github and the source of a donation page, until it's re-added to the members page. | *donate - points to github and the source of a donation page, until it's re-added to the members page. | ||
*echo - simply echos whatever you type after ?echo | *echo - simply echos whatever you type after ?echo | ||
*excuse - gives a programmer excuse for something not working | |||
*fight - followed by two words, or two strings, the two are compared by their google hit count. | *fight - followed by two words, or two strings, the two are compared by their google hit count. | ||
*following - lists how many people are following the group on twitter | *following - lists how many people are following the group on twitter | ||
*ham - gives the date for the next ham radio meeting | |||
*hax - links to the Hacking Is Easy video. | *hax - links to the Hacking Is Easy video. | ||
*hits - uses google to give a hit count to the word or string. | *hits - uses google to give a hit count to the word or string. | ||
| Line 63: | Line 84: | ||
*members - links to the members page on the wiki. | *members - links to the members page on the wiki. | ||
*meter - provides a reading from the power meter [[Electricity meter]]. Useful ones: ?meter UA and ?meter KW | *meter - provides a reading from the power meter [[Electricity meter]]. Useful ones: ?meter UA and ?meter KW | ||
*ning - shouts MORNING! | *minilathe - echos the status of the mini lathe. | ||
*ning - shouts MORNING! or EVENING! depending on [[Equipment/Landin#Chomsky|Chomsky]]'s time. (also see noon) | |||
*noon - shouts AFTERNOON! | |||
*notify - displays a message on the board within the space. Will scroll if above 21 characters, and maximum is 162. | *notify - displays a message on the board within the space. Will scroll if above 21 characters, and maximum is 162. | ||
*phone - gives the telephone number for the space. If a domain name is passed, attempts (naively) to find its phone number. | *phone - gives the telephone number for the space. If a domain name is passed, attempts (naively) to find its phone number. | ||
| Line 73: | Line 96: | ||
*reports - links to the the foundation's monthly reports. | *reports - links to the the foundation's monthly reports. | ||
*rm - Deleting the Internet. | *rm - Deleting the Internet. | ||
*roll - Rolls D&D style dice e.g. ?roll 2D6 | |||
*roulette - play some Russian roulette. | *roulette - play some Russian roulette. | ||
*setBoard - see notify. | *setBoard - see notify. | ||
*shutup-dev | *shutup-dev | ||
*slamthedoor - just what you'd expect from a slammed door - *BANG* | *slamthedoor - just what you'd expect from a slammed door - *BANG* | ||
*snitch - msgs the user the last 5 ?board commands (with usernames) | |||
*spies - lists how many people are watching the webcams. | *spies - lists how many people are watching the webcams. | ||
*summon-dev | *summon-dev | ||
| Line 82: | Line 107: | ||
*time - Gives the date and time rather accurately | *time - Gives the date and time rather accurately | ||
*unwatch | *unwatch | ||
*users - Lists who is logged in to | *users - Lists who is logged in to [[Equipment/Landin#Chomsky|Chomsky]] | ||
*vrms | *vrms | ||
*watch | *watch | ||
| Line 91: | Line 116: | ||
*workshops - Links to the workshops page on the wiki | *workshops - Links to the workshops page on the wiki | ||
*yarnold - A very special command for a very [[User:Solexious|special person]] | *yarnold - A very special command for a very [[User:Solexious|special person]] | ||
*zork - See https://en.wikipedia.org/wiki/Zork | |||
*tube - gets the London Underground status - PM ?tube list for a list of available lines | *tube - gets the London Underground status - PM ?tube list for a list of available lines | ||
*morning - plays the first few seconds of [http://www.youtube.com/watch?v=PAbwMGZtIsY Edvard Grieg - Morning Mood], and cycles the light through dawny colours, and sets the board to say "Good Morning, hackspace" | *morning - plays the first few seconds of [http://www.youtube.com/watch?v=PAbwMGZtIsY Edvard Grieg - Morning Mood], and cycles the light through dawny colours, and sets the board to say "Good Morning, hackspace" | ||
*patriot - initiates enforced patriotism mode | *patriot - initiates enforced patriotism mode | ||
=== Proposed commands to be implemented soon === | |||
(work in progress by xk_id) | |||
*last20 - PMs the most recent 20 chatlines (useful when you've just joined the room) | |||
*addquote <quote> - used in PM only, it adds the quote to the wiki list of IRC quotes. | |||
== Administrative Notes == | |||
To start robonaut, from [[Equipment/Landin#Chomsky|Chomsky]] run the following commands: | |||
# /etc/init.d/irccat start | |||
For some bizzaro reason, irccat requires a TCP connection to localhost (and doesn't time out if it can't establish one), so I've also run this: | |||
$ sudo ip6tables -I INPUT 2 -i lo -j ACCEPT | |||
=== Important Paths === | |||
* Data directory: <code>/opt/irccat/irccat-data</code> | |||
* Contributed scripts directory: <code>/opt/irccat/irccat-commands-contrib</code> | |||
* Persistent scripts directory: <code>/opt/irccat/irccat-commands</code> | |||
* IRCcat installation directory: <code>/opt/irccat/irccat-bin</code> | |||
[[Category:Reference]] | |||
[[Category:Software]] | |||
[[Category:Infrastructure]] | |||
[[Category:Guides]] | |||
