Skip to content

Latest commit

 

History

History
105 lines (67 loc) · 2.36 KB

README.mkd

File metadata and controls

105 lines (67 loc) · 2.36 KB
Raw

bfb is an IRC bot written in brainfuck++

How does it work??

All the source code is written in brainfuck++ in .b files in the src/ directory. You can either run it in the Python interpretor or turn it into C code and then compile it.

Requirements

  • A compiler, either gcc and clang are known to work
  • python 2.5 or later (mainly tested with python 2.6)
  • libssl(-dev) if you want bfb to join ssl irc servers

How to run it?

Using the Python Intrepretor

  • Run bfutils/bfpp-interp.py src/bfb.b
  • Enjoy!

Run it fast!

  • Modify the makefile so that it fits your needs. Defining BFPP_SSL enables SSL support.
  • Type make
  • Run bfb
  • Enjoy!

Configuration

Simple configuration

2 files are needed:

  • server: Write in that file the server bfb should connect to. The format is:

      HOST:PORT

    If you want to use SSL, use instead: HOST:PORT:ssl

  • channels:

    Write in that file all the channels bfb should join. The format is one channel per line.

A third file called pass can be used to set a server password used by bfb. The password is written directly in the file (ended or not by a newline). If no PASS command should be sent, a pass file should be created and the rights Read and Write should be removed on that file with chmod -rw pass for example.

I want to customize it!!

Customize JOIN messages

When bfb joins a channel

You should run the helper.py utility to generate for you brainfuck code!! You have to create the file src/msg/join_bfb_hi.b. Let say your message is Hey CHANNELNAME!!!

You have to run:

bfutils/helper.py -m -s'.^' 'Hey ' > src/msg/join_bfb_hi.b

You should only change the last argument. Then you had the code to display the channel name:

[-]
<[<]>
[.^>]

And finally, you add the last part of your message:

bfutils/helper.py -m -s'.^' '!!!' >> src/msg/join_bfb_hi.b

Of course, displaying the channel name is optional and only one call to helper.py is needed.

When someone joins a channel

It works the same way than customizing the msg sent when bfb joins a channel, but this time the file to modify is src/msg/join_welcome.b To put the name of the joiner in the message, use:

[-]
<[<]<<<[<]>>
[.^>]>>>[>]