List of Configuration Options

From gPodderWiki

Note: This list is automatically generated. If there are errors in it please send a message to the mailing list or file a bug report.

Name	Type	Default	Description
auto_download_when_minimized	bool	False	Automatically download new episodes (only when gPodder is minimized). This is only useful with 'auto_update_feeds' enabled.
auto_remove_old_episodes	bool	False	Remove episodes older than 'episode_old_age' days on startup.
auto_update_feeds	bool	False	Automatically update feeds when gPodder is minimized. See 'auto_update_frequency' and 'auto_download_when_minimized'.
auto_update_frequency	int	20	The frequency (in minutes) at which gPodder will update all feeds if 'auto_update_feeds' is enabled.
bluetooth_converter	str	empty string	The path to an application which can convert the episode to a compatible format for the bluetooth device.
bluetooth_device_address	str	00:00:00:00:00:00	The address of the bluetooth device to sync to. This setting is only useful if 'bluetooth_use_device_address' is enabled.
bluetooth_use_converter	bool	False	Whether or not the bluetooth converter application should be used.See: 'bluetooth_converter'
bluetooth_use_device_address	bool	False	Whether to use the 'bluetooth_device_address' or to search for a device.
cmd_all_downloads_complete	str	empty string	The path to a command that gets run after all downloads are completed.
cmd_download_complete	str	empty string	The path to a command that gets run after a single download completes. See http://wiki.gpodder.org/wiki/Time_stretching for more info.
color_updating_feeds	str	#7db023	The color of the text of currently updating channels.
create_m3u_playlists	bool	False	Create an m3u playlist for every channel.
custom_player_copy_coverart	bool	False	Create custom coverart for FS-based players.
custom_player_coverart_format	str	JPEG	The image format accepted by the user's FS-based player.
custom_player_coverart_name	str	folder.jpg	The name of the coverart file accepted by the user's FS-based player.
custom_player_coverart_size	int	176	The width of the coverart for the user's FS-based player.
custom_sync_name	str	{episode.basename}	The name used when copying a file to a FS-based device. Available options are: episode.basename, episode.title, episode.published
custom_sync_name_enabled	bool	True	Enables renaming files when transfered to an FS-based device with respect to the 'custom_sync_name'.
device_type	str	none	The device type: 'mtp', 'filesystem' or 'ipod'
disable_pre_sync_conversion	bool	False	Disable pre-synchronization conversion of OGG files. This should be enabled for deviced that natively support OGG. Eg. Rockbox, iAudio
display_tray_icon	bool	False	Whether or not gPodder should display an icon in the system tray.
download_dir	str	~/gpodder-downloads	The default directory that podcast episodes are downloaded to.
enable_html_shownotes	bool	True	Allow HTML to be rendered in the episode information dialog.
enable_notifications	bool	True	Let gPodder use notification bubbles when it can completed certain tasks like downloading an episode or finishing syncing to a device.
enable_streaming	bool	False	This will pass a URL to the media player (see: 'player') instead of having to download the episode and then play it.
episode_list_descriptions	bool	True	Display the episode's description under the episode title in the GUI.
episode_old_age	int	7	The number of days before an episode is considered old. Must be used in conjunction with 'auto_remove_old_episodes'.
episode_selector_height	int	400	FIXME: Undocumented
episode_selector_maximized	bool	False	FIXME: Undocumented
episode_selector_width	int	600	FIXME: Undocumented
episode_selector_x	int	100	FIXME: Undocumented
episode_selector_y	int	100	FIXME: Undocumented
episode_window_height	int	400	FIXME: Undocumented
episode_window_maximized	bool	False	FIXME: Undocumented
episode_window_width	int	500	FIXME: Undocumented
episode_window_x	int	100	FIXME: Undocumented
episode_window_y	int	100	FIXME: Undocumented
fssync_channel_subfolders	bool	True	Create a directory for every feed when syncing to an FS-based device instead of putting all the episodes in a single directory.
ftp_proxy	str	empty string	The URL for proxy to use for FTP downloads. Requires that 'proxy_use_environment' be 'False'
get_length_from_http_header_if_empty	bool	False	If the reported file length in the RSS feed is invalid, try getting from the server instead.
http_proxy	str	empty string	The URL for proxy to use for HTTP downloads. Requires that 'proxy_use_environment' be 'False'
ipod_mount	str	/media/ipod	The moint point for an iPod Device.
ipod_purge_old_episodes	bool	False	Remove episodes from an iPod device if they've been marked as played on the device and they have no rating set (the rating can be set on the device by the user to prevent deletion).
ipod_write_gtkpod_extended	bool	False	Create a GTKpod extended database on an iPod device after syncing for greater compatibility with GTKpod.
limit_rate	bool	False	The 'limit_rate_value' setting will only work if this is set to 'True'.
limit_rate_value	float	500.0	Set a global speed limit (in KB/s) when downloading files. Requires 'limit_rate'.
log_sqlite	bool	False	Enable _very_ verbose logging from the dbsqlite module.
maemo_allow_custom_player	bool	False	This must be enabled on Maemo in order to be able to use a media player other than Nokia's built-in media player.
maemo_enable_gestures	bool	False	Enable fancy gestures on Maemo.
main_window_height	int	500	FIXME: Undocumented
main_window_maximized	bool	False	FIXME: Undocumented
main_window_width	int	700	FIXME: Undocumented
main_window_x	int	100	FIXME: Undocumented
main_window_y	int	100	FIXME: Undocumented
max_downloads	int	3	The maximum number of simultaneous downloads allowed at a single time. Requires 'max_downloads_enabled'.
max_downloads_enabled	bool	False	The 'max_downloads' setting will only work if this is set to 'True'.
max_episodes_per_feed	int	200	The maximum number of episodes that gPodder will display in the episode list. Note: Set this to a lower value on slower hardware to speed up rendering of the episode list.
max_simulaneous_feeds_updating	int	3	The maximum number of feeds that can be updating at a time. Set this to a low number on low-powered machines and a higher number on faster PCs.
minimize_to_tray	bool	False	If 'display_tray_icon' is enabled, when gPodder is minimized it will not be visible in the window list.
mp3_player_delete_played	bool	False	Removes episodes from an FS-based device that have been marked as played in gPodder. Note: only works if 'only_sync_not_played' is also enabled.
mp3_player_folder	str	/media/usbdisk	The moint point for an FS-based device.
mp3_player_max_filename_length	int	100	The maximum filename length for FS-based devices.
mp3_player_playlist_absolute_path	bool	True	Whether or not the the playlist should contain relative or absolute paths; this is dependent on the player.
mp3_player_playlist_file	str	PLAYLISTS/gpodder.m3u	The relative path to where the playlist is stored on an FS-based device.
mp3_player_playlist_win_path	bool	True	Whether or not the player requires Windows-style paths in the playlist.
mp3_player_use_scrobbler_log	bool	False	Attempt to use a Device's scrobbler.log to mark episodes as played in gPodder. Useful for Rockbox players.
my_gpodder_autoupload	bool	False	Upload the user's podcast list to the gPodder web services when gPodder is closed.
my_gpodder_password	str	empty string	The user's gPodder web services password.
my_gpodder_username	str	empty string	The user's gPodder web services username.
on_quit_ask	bool	True	Ask the user to confirm quitting the application.
on_quit_systray	bool	False	When the 'X' button is clicked do not quit, send gPodder to the tray.
on_sync_delete	bool	False	After syncing an episode, delete it from gPodder.
on_sync_mark_played	bool	False	After syncing an episode, mark it as played in gPodder.
only_sync_not_played	bool	False	Only sync episodes to a device that have not been marked played in gPodder.
opml_url	str	http://gpodder.org/directory.opml	A URL pointing to an OPML file which can be used to bulk-add feeds.
paned_position	int	200	The width of the channel list.
player	str	default	The default player for all media, if set to 'default' this will attempt to use xdg-open on linux or the built-in media player on maemo.
podcast_list_icon_size	int	32	The width of the icon used in the podcast channel list.
podcast_sidebar_save_space	bool	False	Hide the cover/pill from the podcast sidebar when it gets too small.
proxy_use_environment	bool	True	Use your environment's (Eg. Gnome's) proxy settings instead of gPodder's. See 'http_proxy' and 'ftp_proxy'.
resume_ask_every_episode	bool	False	If there are episode downloads that can be resumed, ask whether or not to resume every single one.
reverse_m3u_playlist_order	bool	False	Reverse the order of the gPodder-generated m3u playlists.
rockbox_copy_coverart	bool	False	Create rockbox-compatible coverart and copy it to the device when syncing. See: 'rockbox_coverart_size'.
rockbox_coverart_size	int	100	The width of the coverart for the user's Rockbox player/skin.
show_toolbar	bool	True	Show the toolbar in the GUI's main window.
show_url_entry_in_podcast_list	bool	False	Whether or not to show the URL entry (add podcast) box in the main window.
start_iconified	bool	False	When gPodder starts, send it to the tray immediately.
sync_disks_after_transfer	bool	True	Call 'sync' after tranfering episodes to a device.
toplist_url	str	http://gpodder.org/toplist.opml	A URL pointing to a gPodder web services top podcasts list
update_on_startup	bool	False	Update the feed cache on startup.
update_tags	bool	False	Update tags on files after they've been downloaded. This sets the artist tag to the title of the feed (can be customized in the feed's preferences) and genre tag to 'Podcast'.
use_si_units	bool	False	Use SI units (KB instead of KiB) in the episodes list.
videoplayer	str	unspecified	The default player for video, if set to 'unspecified' this will use whatever 'player' is set to.