view release on metacpan or  search on metacpan

bin/toot  view on Meta::CPAN

=head1 DESCRIPTION

C<toot> is a tool for posting to Mastodon.

=head1 OPTIONS

=over

=item --config <name>

The section of the config to load credentials for.

Optional.  Defaults to C<default>.

For more details, see the documentation for L<App::Toot::Config> or C<perldoc App::Toot::Config>.

=item --status <status to post>

The status to post.

Optional.  If not defined, status is taken from C<STDIN>.

lib/App/Toot/Config.pm  view on Meta::CPAN

=head3 ARGUMENTS

The defined section name is required and dies if not found in the loaded config.

=head3 RETURNS

Returns a hashref of the loaded config for the defined section name.

=head1 CONFIGURATION

To post to Mastodon, you need to provide the account's oauth credentials in the file C<config.ini>.

An example is provided as part of this distribution.  The user running the L<toot> script, for example through cron, will need access to the configuration file.

To set up the configuration file, copy C<config.ini.example> into one of the following locations:

=over

=item C<$ENV{HOME}/.config/toot/config.ini>

=item C</etc/toot/config.ini>

=back

After creating the file, edit and update the values in the C<default> section to match the account's oauth credentials.

 [default]
 instance = mastodon.social
 username = youruser
 client_id = OKE98_kdno_NOTAREALCLIENTID
 client_secret = mkjklnv_NOTAREALCLIENTSECRET
 access_token = jo83_NOTAREALACCESSTOKEN

B<NOTE:> If the C<$ENV{HOME}/.config/toot/> directory exists, C<config.ini> will be loaded from there regardless of a config file in C</etc/toot/>.