view release on metacpan or  search on metacpan

lib/Alice/Readme.pod  view on Meta::CPAN

=item -d --debug

Print out additional debug information. Useful for development or
finding out if something is wrong.

=item -p --port

This will change the port that the HTTP server listens on. The
default port is 8080.

=item -a --address

This will change the IP address that the HTTP server listens on.
The default address is 127.0.0.1. That means alice only accepts
local connections by default. If you want to connect to alice
remotely you should change it to the IP you want to listen on, or
0.0.0.0 to listen on all addresses.

=back

=head1 CONFIGURATION

Most of alice can be configured through the web interface. There
are two windows that can be used to alter the configuration,
Connections and Preferences. To bring up either of these windows
click the gear icon in the bottom right hand corner of the page.

This B<should> bring up the new window. Some browsers (specifically
Chrome) will block this popup by default. If it doesn't appear make
sure that you allow popups!

=head2 CONNECTION WINDOW

The connection window is used to add or remove servers. It should be
familiar if you have ever used an IRC client (and I assume you have.)

The only difference of note is the "Avatar" field. In reality, this field
just sets the B<realname>. Alice abuses this field to get avatars for users.
If a user has an image URL or an email address as their realname, alice
will display the image next too their messages. This feature can be disabled
in the Preferences window.

=head2 PREFERENCES WINDOW

The Preferences window can be used to set configuration options that
are not connection specific. You can toggle the use of avatars, timestamps,
and notifications. You can also edit a list of highlightable terms.

=head2 HTTP AUTHENTICATION

Some configuration options do not have a UI yet. The most notable
of these options is HTTP authentication. If you would like to use
HTTP authentication, you will have to edit your configuration file
by hand. You can find this file at ~/.alice/config.

The config is simply a perl hash. So, if you are familiar with perl it
should not be too intimidating. If you do not know perl, sorry! :)

You will need to add "user" and "pass" values to the "auth" hash.
The resulting section of configuration might look like this:

    'auth' => {
      'user' => 'lee',
      'pass' => 'mypassword',
    },

=head1 COMMANDS

=over 4

=item /j[oin] [-network] $channel

Takes a channel name as an argument, and an optional network flag.
If no network flag is provided, it will use the network of the
current tab.

=item /close

Closes the current tab. If used in a channel it will also part the
channel.

B</wc> and B</part> are aliases for /close

=item /clear

This will clear the current tab's messages from your browser. It
will also clear the tab's message buffer so when you refresh your
browser the messages won't re-appear.

=item /msg [-network] <nick> [<msg>]

Takes a nick as an argument and an optional network flag. If no
network flag is provided, it will use the network of the current
tab. A third argument may be used for the message text. If no message
text is provided, a blank tab will be opened.

B</query> is an alias for /msg

=item /whois [-force] <nick>

Takes a nick as an argument and an optional force flag. This will
print some information about the supplied user. If the force flag
is provided, the information will be refreshed from the server.

=item /quote <command>

Sends a string as a raw message to the server.

B</raw> is an alias for /quote

=item /t[opic] [<topic>]

Takes an optional topic string. This will display the topic for the
current tab.  If a string is supplied, it will attempt to update
the channel's topic.  Only works in a channel.

=item /n[ames] [-avatars]

This will print a table of all of the nicks in the current tab.  An
optional avatars flag can be provided to include avatars.