# Configure Sahi

browser_types.xml
userdata.properties
exclude_inject.txt
download_urls.txt
download_contenttypes.txt
block_ssl_domains.txt

## browser_types.xml

browser_types.xml configures the various browsers that Sahi can use. Note that browser options for various browsers are different and it is advisable to use the defaults provided and only change the paths where needed.

## userdata.properties

Sahi can be configured using two files:

1. sahi/userdata/config/ userdata.properties
2. sahi/config/sahi.properties (View)

Sahi first looks for a property in userdata.properties, and if not found, looks for it in sahi.properties.
It is recommended to modify/add properties to userdata.properties.
Every property in sahi.properties can be overridden in userdata.properties

## exclude_inject.txt

Sahi controls the browser by injecting javascript into web pages. However there are various requests like XMLHttpRequests, javascript, css, etc. where Sahi should not inject its code. While this is correctly detected and handled in most cases, there are instances where one may need to explicitly ask Sahi not to inject code. In such instances, patterns can be added to exclude_inject.txt. When a URL matches this pattern, Sahi will NOT inject its code.

## download_urls.txt

Sahi automatically downloads and saves files into sahi/usedata/temp/downloads directory. If Sahi is unable to detect a request as a download, you can force it to download the file by adding URL patterns to this file.

## download_contenttypes.txt

Sahi automatically downloads and saves files into sahi/usedata/temp/downloads directory. If Sahi is unable to detect a request as a download, you can force it to download the file by adding relevant content-types to this file.

## block_ssl_domains.txt

If a domain is added here, any HTTPS calls to this domain will return a 404 error. Browsers like firefox make HTTPS requests to addons.mozilla.org and sb-ssl.google.com which can hang playback. Adding these domains to block_ssl_domains.txt will prevent hangs.
Your configuration has been saved. Please restart Sahi