beagles(1)

# NAME

beagles - TUI RSS feed aggregator

# SYNOPSIS

*beagles* [POSIX style options] ...

# DESCRIPTION

_beagles_ is a terminal user interface RSS aggregator that allows++
you to keep track of RSS feeds, favorite them for quick reference,++
or even play the podcasts available on the feed.

# OPTIONS

*-c [directory]*
	Set the config directory.  If not set, use *XDG_CONFIG_HOME*/beagles.

*-d [directory]*
	Set the database directory.  If not set, use *XDG_DATA_HOME*/beagles.

*-D*
	Print debug lines.

*-g [directory]*
	Set the directory for your gemini known_hosts.  If not set, use++
*XDG_DATA_HOME*/gemini.

*-h*
	Print basic usage options.

*-l [directory]*
	Set the logging directory.  If not set, use *XDG_CACHE_HOME*/beagles.

*-s [directory]*
	Set the download directory. If not set use *XDG_DATA_HOME*/beagles.

*-V*
	Print version information


# USAGE

## GENERAL

*L*
	display list page

*S*
	display subscriptions page

*F*
	display favorites page

*?*
	display help page

*h*
	move to the left section (if applicable)

*j*
	navigate down in the current section (if applicable)

*k*
	navigate up in the current section (if applicable)

*l*
	move the the right section (if applicable)

*PgUp*
	navigate upward quicker (if applicable)

*PgDn*
	navigate downward quicker (if applicable)

*m*
	mark current post as read when in LIST, CONTENT, or SUBSCRIPTIONS

*u*
	mark current post as unread when in CONTENT or SUBSCRIPTIONS

*f*
	mark current post as favorite when in LIST, CONTENT, or
SUBSCRIPTIONS

*c*
	unmark current post as favorite when in LIST, CONTENT,++
SUBSCRIPTIONS, or FAVORITES

*n*
	open post url when in LIST, CONTENT, SUBSCRIPTIONS, or FAVORITES

*d*
	download a single podcast when in LIST, CONTENT, SUBSCRIPTIONS,++
or FAVORITES

*p*
	play single podcast when in LIST, CONTENT, SUBSCRIPTIONS, or++
FAVORITES

*ENTER*
	expand/collapse subscription in SUBSCRIPTIONS

*:*
	enter command mode

## COMMAND MODE

*add* [url]
	add a feed

*export* [path]
	export an opml file

*help, h*
	display help page

*hide*
	hide read posts in SUBSCRIPTIONS

*import* [path]
	import an opml file

*quit, q*
	exit the application

*remove, rm* [url]
	remove the feed, note you can omit the url if you are in the++
subscription page on a current feed

*unhide*
	unhide read posts in SUBSCRIPTIONS

*update, up*
	update all feeds


# CONFIGURATION

See *beagles-config*(5)

# BUGS

https://todo.sr.ht/~chrisppy/beagles

# HOMEPAGE

https://sr.ht/~chrisppy/beagles

# SEE ALSO

*beagles-config*(5)

# AUTHORS

Written and maintained by Chris Palmer

beagles v0.2.0 is available under the terms of the GPL-3.0 license.

Copyright © 2020  Chris Palmer <chris@red-oxide.org>