SnarkManager (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- org.klomp.snark.SnarkManager

All Implemented Interfaces:
ClientApp, I2PSocketManager.DisconnectListener, CompleteListener
```
public class SnarkManager
extends Object
implements CompleteListener, ClientApp, I2PSocketManager.DisconnectListener
```
Central manager for multiple torrent downloads and the I2PSnark application.
This class is the core controller that manages:
- Multiple torrent instances (Snarks) and their lifecycle
- Configuration management and persistence
- Peer coordination and bandwidth management
- Tracker communication and DHT integration
- Web interface and user interaction
- Torrent file monitoring and auto-loading
- Magnet link handling
- Comments and metadata management
As a ClientApp, it integrates with the I2P router application framework and can be started, stopped, and monitored through the standard I2P interfaces.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CONFIG_DIR_SUFFIX`
`static String`	`CONFIG_FILE`
`static String`	`DEFAULT_BACKUP_TRACKER` URL.
`static int`	`DEFAULT_BAN_DISCARD_PERIOD`
`static String`	`DEFAULT_BAN_DISCARD_RATIO`
`static String`	`DEFAULT_ENABLE_ADDCREATE`
`static String`	`DEFAULT_ENABLE_LIGHTBOX`
`static int`	`DEFAULT_MAX_FILES_PER_TORRENT`
`static int`	`DEFAULT_MAX_UP_BW`
`static int`	`DEFAULT_MULTI_DEST_MAX` Default cap on destinations so many torrents share destinations instead of exhausting memory
`static String`	`DEFAULT_PREALLOCATE_FILES`
`static int`	`DEFAULT_REFRESH_DELAY_SECS`
`static String`	`DEFAULT_SHOULD_PAD_FILES`
`static String`	`DEFAULT_SHOW_STATUSFILTER`
`static int`	`DEFAULT_STARTUP_DELAY_MAX`
`static int`	`DEFAULT_STARTUP_DELAY_MIN`
`static String`	`DEFAULT_THEME`
`static Set<String>`	`DEFAULT_TRACKER_ANNOUNCES` Default set of tracker announce URLs to use when no torrent trackers are configured.
`static int`	`DEFAULT_TUNNEL_QUANTITY`
`(package private) static Set<String>`	`KNOWN_OPENTRACKERS` Host names for config form.
`static int`	`MAX_MULTI_DEST` Absolute maximum for the destination cap
`static int`	`MIN_DOWN_BW`
`static int`	`MIN_UP_BW`
`static String`	`PROP_AUTO_START`
`static String`	`PROP_BAN_DISCARD_PERIOD` Duration of the ban applied to peers with an excessive discard ratio, in minutes.
`static String`	`PROP_BAN_DISCARD_RATIO` Disconnect peers that cancel most of what they request.
`static String`	`PROP_BROWSER_API` Whether the nonce-free browser API (magnet/torrent add) is enabled.
`static String`	`PROP_BROWSER_API_HOSTS` Comma-separated hosts (IPs or hostnames) allowed to use the browser API without a nonce, in addition to loopback.
`static String`	`PROP_CLIENT_ID` Client identity spoofing: empty (default) to identify as I2PSnark, "random" to pick a random known client profile per destination per run, or the name of a known client (e.g.
`static String`	`PROP_CLIENT_IDS` Optional comma-separated subset of client names (see `ClientID.profiles()`) to choose from when `PROP_CLIENT_ID` is "random"; unknown names are ignored.
`static String`	`PROP_COLLAPSE_PANELS`
`static String`	`PROP_DEST_CYCLE` Whether running torrents are periodically stopped and restarted so their destinations rotate to fresh identities, breaking long-lived linkage between the router's IP and the torrents' destinations at trackers and in the DHT.
`static String`	`PROP_DIR`
`static String`	`PROP_DOWNBW_MAX`
`static String`	`PROP_ENABLE_ADDCREATE`
`static String`	`PROP_ENABLE_LIGHTBOX`
`static String`	`PROP_FILES_PUBLIC`
`static String`	`PROP_I2CP_HOST`
`static String`	`PROP_I2CP_OPTS`
`static String`	`PROP_I2CP_PORT`
`static String`	`PROP_MAX_FILES_PER_TORRENT`
`static String`	`PROP_MAX_MESSAGES`
`static String`	`PROP_MAX_PARTSIZE` Cap on a single piece request from a peer.
`static String`	`PROP_MAX_PIPELINE` Maximum request pipeline depth for outbound requests.
`static String`	`PROP_MIN_PIPELINE` Minimum request pipeline depth for outbound requests.
`static String`	`PROP_MULTI_DEST` Whether each torrent runs on its own destination.
`static String`	`PROP_MULTI_DEST_MAX` Maximum number of destinations in multi-dest mode, 0 for one per torrent.
`static String`	`PROP_OLD_AUTO_START`
`static String`	`PROP_OPENTRACKERS`
`static String`	`PROP_PAGE_SIZE`
`static String`	`PROP_PARTSIZE` Chunk size for outbound piece requests.
`static String`	`PROP_PREALLOCATE_FILES`
`static String`	`PROP_PRIVATETRACKERS`
`static String`	`PROP_RANDOMIZE_STARTUP` Stagger batched starts with a random delay, so torrents that start together cannot be correlated by trackers or DHT peers, and tunnel builds are spread out.
`static String`	`PROP_REFRESH_DELAY`
`static String`	`PROP_SHOULD_PAD_FILES` Add BEP 47 padding files to new torrents.
`static String`	`PROP_SHOW_STATUSFILTER`
`static String`	`PROP_STARTUP_DELAY_MAX`
`static String`	`PROP_STARTUP_DELAY_MIN`
`static String`	`PROP_TEMP_DIR` Configuration key for the staging directory where incomplete files are written until a file's pieces are all downloaded, at which point the file is copied into the data directory.
`static String`	`PROP_THEME`
`static String`	`PROP_TORRENT_CREATE_FILTERS` Comma delimited list of name=filterPattern for torrent create filters.
`static String`	`PROP_TORRENT_FILTERS_CONFIG` Filename for serialized torrent filters config.
`static String`	`PROP_TRACKERS` Comma delimited list of name=announceURL=baseURL for the trackers to be displayed.
`static String`	`PROP_UPBW_MAX`
`static String`	`PROP_UPLOADERS_TOTAL`
`static String`	`PROP_VARY_INBOUND_HOPS`
`static String`	`PROP_VARY_OUTBOUND_HOPS`
`static String`	`RC_PROP_THEME`
`static String`	`RC_PROP_UNIVERSAL_THEMING`

Constructor Summary
Constructors
Constructor and Description
SnarkManager(I2PAppContext ctx)
For embedded.
SnarkManager(I2PAppContext ctx, String ctxPath, String ctxName)
For webapp.

Constructors
Constructor and Description
`SnarkManager(I2PAppContext ctx)` For embedded.
`SnarkManager(I2PAppContext ctx, String ctxPath, String ctxName)` For webapp.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addDownloader(Snark torrent)` Add and start a FetchAndAdd task.
`void`	`addMagnet(String name, byte[] ih, String trackerURL, boolean updateStatus)` Add a torrent with the info hash alone (magnet / maggot)
`Snark`	`addMagnet(String name, byte[] ih, String trackerURL, boolean updateStatus, boolean autoStart, File dataDir, CompleteListener listener)` Add a torrent with the info hash alone (magnet / maggot) External use is for UpdateRunner.
`void`	`addMagnet(String name, byte[] ih, String trackerURL, boolean updateStatus, File dataDir)` Add a torrent with the info hash alone (magnet / maggot)
`void`	`addMessage(Snark snark, String message)` A Snark.CompleteListener method.
`void`	`addMessage(String message)` Use if it does not include a link.
`void`	`addMessageAndPrint(String message)` Queue a message and, when running standalone, print it to stdout.
`void`	`addMessageAndPrint(String message, String print)` Queue a message and, when running standalone, print possibly different text to stdout.
`void`	`addMessageNoEscape(String message)` Use if it includes a link.
`void`	`addMessageNoEscapeAndPrint(String message)` Queue a message and, when running standalone, print it to stdout.
`void`	`addMessageNoEscapeAndPrint(String message, String print)` Queue a message and, when running standalone, print possibly different text to stdout.
`boolean`	`addTorrent(MetaInfo metainfo, BitField bitfield, String filename, File baseFile, boolean dontAutoStart)` Add a torrent from a MetaInfo.
`boolean`	`areFilesPublic()` Whether the files in the data directory are world-readable.
`boolean`	`browserApiEnabled()` Whether the nonce-free browser API for adding torrents is enabled.
`void`	`clearMessages()`
`void`	`clearMessages(int id)` Clear through this id
`boolean`	`copyAndAddTorrent(File fromfile, String filename, File dataDir)` Add a torrent from a file not in the torrent directory.
`(package private) static int`	`countRealFiles(List<List<String>> files)` Count the files in a metainfo file list for the max files per torrent check, excluding BEP 47 padding files (.pad) and parse-renamed padding (_pad); a padded torrent must not be rejected because of its synthetic zero files.
`void`	`deleteMagnet(Snark snark)` Stop and delete a torrent running in magnet mode
`static String`	`escapeMessage(String message)` Escape a message for HTML display, preserving intentional ' ' spacers.
`void`	`fatal(Snark snark, String error)` A Snark.CompleteListener method.
`BandwidthListener`	`getBandwidthListener()` The bandwidth listener for this manager.
`String`	`getBrowserApiHosts()` The raw comma-separated browser API allowed hosts config, for the config form.
`File`	`getConfigDir()` For RPC
`int`	`getCreateFilterCount()` Returns the current number of configured file filters
`File`	`getDataDir()` The configured torrent data directory.
`String`	`getDiskUsage()` The cached disk usage string for display.
`String`	`getDisplayName()` ClientApp method.
`int`	`getMaxFilesPerTorrent()` Maximum number of files a torrent may contain.
`int`	`getMaxLogMessages()` Maximum number of messages kept for display on the web page.
`List<UIMessages.Message>`	`getMessages()` The list of recent UI messages for display on the web page.
`String`	`getName()` ClientApp method.
`int`	`getPageSize()` For GUI
`List<String>`	`getPrivateTrackers()` The configured private tracker list.
`boolean`	`getRandomizeStartupDelay()` Whether batched torrent starts are staggered with a random delay, so torrents starting together cannot be correlated, and tunnel builds are spread out.
`int`	`getRefreshDelaySeconds()` How often the web page refreshes itself.
`long[]`	`getSavedAddedAndCompleted(Snark snark)` Setting for a torrent from the config file.
`CommentSet`	`getSavedComments(Snark snark)` The comments for a torrent
`boolean`	`getSavedCommentsEnabled(Snark snark)` Setting for comments enabled from the config file.
`boolean`	`getSavedPreserveNamesSetting(Snark snark)` Setting for a torrent from the config file.
`BitField`	`getSavedTorrentBitField(Snark snark)` Saved bitfield for a torrent from the config file.
`long`	`getSavedTorrentTime(Snark snark)` Timestamp for a torrent from the config file.
`long`	`getSavedUploaded(Snark snark)` Setting for a torrent from the config file.
`List<TorrentCreateFilter>`	`getSortedTorrentCreateFilterStrings()` Sorted copy
`List<Tracker>`	`getSortedTrackers()` Sorted copy
`ClientAppState`	`getState()` ClientApp method.
`String`	`getTheme()` The current theme for this web interface.
`String[]`	`getThemes()` All themes available for this web interface.
`String`	`getTime()`
`Snark`	`getTorrent(String filename)` Grab the torrent given the (canonical) filename of the .torrent file
`Snark`	`getTorrentByBaseName(String filename)` Grab the torrent given the base name of the storage
`Snark`	`getTorrentByInfoHash(byte[] infohash)` Grab the torrent given the info hash
`Map<String,TorrentCreateFilter>`	`getTorrentCreateFilterMap()` Unsorted map of name to TorrentCreateFilter object Modifiable, not a copy
`Collection<TorrentCreateFilter>`	`getTorrentCreateFilterStrings()` Unsorted, do not modify
`Collection<Snark>`	`getTorrents()` Unmodifiable
`Map<String,Tracker>`	`getTrackerMap()` Unsorted map of name to Tracker object Modifiable, not a copy
`Collection<Tracker>`	`getTrackers()` Unsorted, do not modify
`boolean`	`getUniversalTheming()` Whether themes are applied across all applications.
`String`	`gotMetaInfo(Snark snark)` We transitioned from magnet mode, we have now initialized our metainfo and storage.
`void`	`gotPiece(Snark snark)` A Snark.CompleteListener method.
`boolean`	`hasModifiedTrackers()` Has the default tracker list been modified?
`boolean`	`isBrowserApiHost(String host)` Whether the given remote address may use the browser API without a nonce.
`boolean`	`isCollapsePanelsEnabled()` Whether the web interface collapses panels by default.
`boolean`	`isEnableLightbox()` Whether the lightbox is used to display large images in the web interface.
`static boolean`	`isLoopbackHost(String host)` IPv4 loopback (127/8), IPv6 loopback, and "localhost".
`boolean`	`isShowStatusFilter()` Whether the status filter bar is shown in the web interface.
`boolean`	`isSmartSortEnabled()` Whether smart sort is enabled in the web interface.
`boolean`	`isStopping()` Whether the manager is in the process of stopping.
`boolean`	`isVaryInboundHops()` Whether hops are randomly varied for inbound torrent tunnels.
`boolean`	`isVaryOutboundHops()` Whether hops are randomly varied for outbound torrent tunnels.
`Set<String>`	`listTorrentFiles()` Canonical .torrent filenames that we are dealing with.
`void`	`loadConfig(String filename)` Load the config from the given file.
`void`	`loadSavedFilePriorities(Snark snark)` Saved priorities for a torrent from the config file.
`void`	`locked_saveComments(Snark snark, CommentSet comments)` Save the comments for a torrent Caller must synchronize on comments.
`(package private) static boolean`	`parseShouldPadFiles(Properties props)` Parses the `PROP_SHOULD_PAD_FILES` value from the given properties, applying the default when absent or unparsable.
`void`	`recheckTorrent(Snark snark)` Threaded.
`void`	`removeMagnetStatus(byte[] ih)` Remove the magnet marker from the config file.
`void`	`removeTorrent(String filename)` Stop the torrent and delete the torrent file itself, but leaving the data behind.
`static Set<InetAddress>`	`resolveBrowserApiHosts(String hosts)` Parse a comma-separated host list into resolved addresses.
`void`	`saveConfig()`
`void`	`saveMagnetStatus(byte[] ih, String dir, String trackerURL, String dn)` Just remember we have it.
`void`	`saveOpenTrackers(List<String> ot)` Save the given open tracker list.
`void`	`savePrivateTrackers(List<String> pt)` Save the given private tracker list.
`void`	`saveTorrentCreateFilterMap()`
`void`	`saveTorrentStatus(Snark snark)` Save the completion status of a torrent and other data in the config file for that torrent.
`void`	`saveTrackerMap()`
`void`	`sessionDisconnected()` DisconnectListener interface
`void`	`setAPI(String target, String key)` Set and persist the API key for remote access, mirroring the apiKey/apiTarget handling in updateConfig.
`void`	`setBrowserApi(boolean enable, String hosts)` Set and persist the browser API enable flag and allowed hosts list.
`void`	`setDefaultTorrentCreateFilterMap()`
`void`	`setDefaultTrackerMap()`
`void`	`setSavedCommentsEnabled(Snark snark, boolean yes)` Setting for comments enabled in the config file.
`boolean`	`shouldAutoStart()` Whether newly added torrents should be started automatically.
`boolean`	`shouldDestCycle()` Whether running torrents are periodically restarted with fresh destinations.
`boolean`	`shouldPreallocateFiles()` Whether new torrents preallocate their storage files.
`void`	`shutdown(String[] args)` ClientApp method.
`void`	`start()` Caller _must_ call loadConfig(file) before this if setting new values for i2cp host/port or i2psnark.dir
`void`	`startAllTorrents()` Always thread it
`(package private) static long`	`startDelay(Random rnd)` Random delay between auto-started torrents in multi-dest mode, 30-90 seconds.
`void`	`startTorrent(byte[] infoHash)` If not connected, thread it, otherwise inline
`void`	`startTorrent(Snark snark)` If not connected, thread it, otherwise inline
`void`	`startup()` ClientApp method.
`void`	`stop()` Called by the webapp at Jetty shutdown.
`void`	`stopAllTorrents(boolean finalShutdown)` Stop all running torrents, and close the tunnel after a delay to allow for announces.
`void`	`stopTorrent(Snark torrent)` Stop the torrent only, leaving it on the list of torrents.
`void`	`stopTorrent(Snark torrent, boolean shouldRemove)` Stop the torrent, leaving it on the list of torrents unless told to remove it.
`Snark`	`stopTorrent(String filename, boolean shouldRemove)` Stop the torrent, leaving it on the list of torrents unless told to remove it.
`void`	`torrentComplete(Snark snark)` A Snark.CompleteListener method.
`void`	updateConfig(String dataDir, boolean filesPublic, boolean autoStart, String refreshDelay, String startDelayMin, String startDelayMax, String pageSize, String seedPct, String eepHost, String eepPort, String i2cpHost, String i2cpPort, String i2cpOpts, String upLimit, String upBW, String downBW, boolean useOpenTrackers, boolean useDHT, String theme, String lang, boolean enableRatings, boolean enableComments, String commentName, boolean collapsePanels, boolean showStatusFilter, boolean enableLightbox, boolean enableAddCreate, boolean enableVaryInboundHops, boolean enableVaryOutboundHops, boolean multiDest, String multiDestMax, boolean randomizeStartup, String apiTarget, String apiKey, String maxFiles, boolean preallocateFiles, String tempDir) All params may be null or need trimming.
`void`	`updateStatus(Snark snark)` A Snark.CompleteListener method.
`I2PSnarkUtil`	`util()` The I2PSnarkUtil instance for this manager.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CONFIG_DIR_SUFFIX
```
public static final String CONFIG_DIR_SUFFIX
```
    See Also:
    Constant Field Values
  - CONFIG_FILE
```
public static final String CONFIG_FILE
```
    See Also:
    Constant Field Values
  - DEFAULT_BACKUP_TRACKER
```
public static final String DEFAULT_BACKUP_TRACKER
```
    URL. This is our equivalent to router.utorrent.com for bootstrap
    See Also:
    Constant Field Values
  - DEFAULT_BAN_DISCARD_PERIOD
```
public static final int DEFAULT_BAN_DISCARD_PERIOD
```
    See Also:
    Constant Field Values
  - DEFAULT_BAN_DISCARD_RATIO
```
public static final String DEFAULT_BAN_DISCARD_RATIO
```
    See Also:
    Constant Field Values
  - DEFAULT_ENABLE_ADDCREATE
```
public static final String DEFAULT_ENABLE_ADDCREATE
```
    See Also:
    Constant Field Values
  - DEFAULT_ENABLE_LIGHTBOX
```
public static final String DEFAULT_ENABLE_LIGHTBOX
```
    See Also:
    Constant Field Values
  - DEFAULT_MAX_FILES_PER_TORRENT
```
public static final int DEFAULT_MAX_FILES_PER_TORRENT
```
    See Also:
    Constant Field Values
  - DEFAULT_MAX_UP_BW
```
public static final int DEFAULT_MAX_UP_BW
```
    See Also:
    Constant Field Values
  - DEFAULT_MULTI_DEST_MAX
```
public static final int DEFAULT_MULTI_DEST_MAX
```
    Default cap on destinations so many torrents share destinations instead of exhausting memory
    See Also:
    Constant Field Values
  - DEFAULT_PREALLOCATE_FILES
```
public static final String DEFAULT_PREALLOCATE_FILES
```
    See Also:
    Constant Field Values
  - DEFAULT_REFRESH_DELAY_SECS
```
public static final int DEFAULT_REFRESH_DELAY_SECS
```
    See Also:
    Constant Field Values
  - DEFAULT_SHOULD_PAD_FILES
```
public static final String DEFAULT_SHOULD_PAD_FILES
```
    See Also:
    Constant Field Values
  - DEFAULT_SHOW_STATUSFILTER
```
public static final String DEFAULT_SHOW_STATUSFILTER
```
    See Also:
    Constant Field Values
  - DEFAULT_STARTUP_DELAY_MAX
```
public static final int DEFAULT_STARTUP_DELAY_MAX
```
    See Also:
    Constant Field Values
  - DEFAULT_STARTUP_DELAY_MIN
```
public static final int DEFAULT_STARTUP_DELAY_MIN
```
    See Also:
    Constant Field Values
  - DEFAULT_THEME
```
public static final String DEFAULT_THEME
```
    See Also:
    Constant Field Values
  - DEFAULT_TRACKER_ANNOUNCES
```
public static final Set<String> DEFAULT_TRACKER_ANNOUNCES
```
    Default set of tracker announce URLs to use when no torrent trackers are configured.
  - DEFAULT_TUNNEL_QUANTITY
```
public static final int DEFAULT_TUNNEL_QUANTITY
```
    See Also:
    Constant Field Values
  - KNOWN_OPENTRACKERS
```
static final Set<String> KNOWN_OPENTRACKERS
```
    Host names for config form.
  - MAX_MULTI_DEST
```
public static final int MAX_MULTI_DEST
```
    Absolute maximum for the destination cap
    See Also:
    Constant Field Values
  - MIN_DOWN_BW
```
public static final int MIN_DOWN_BW
```
    See Also:
    Constant Field Values
  - MIN_UP_BW
```
public static final int MIN_UP_BW
```
    See Also:
    Constant Field Values
  - PROP_AUTO_START
```
public static final String PROP_AUTO_START
```
    See Also:
    Constant Field Values
  - PROP_BAN_DISCARD_PERIOD
```
public static final String PROP_BAN_DISCARD_PERIOD
```
    Duration of the ban applied to peers with an excessive discard ratio, in minutes.
    See Also:
    Constant Field Values
  - PROP_BAN_DISCARD_RATIO
```
public static final String PROP_BAN_DISCARD_RATIO
```
    Disconnect peers that cancel most of what they request. Off by default; conservative thresholds and a minimum-volume guard protect legitimate peers under congestion.
    See Also:
    Constant Field Values
  - PROP_BROWSER_API
```
public static final String PROP_BROWSER_API
```
    Whether the nonce-free browser API (magnet/torrent add) is enabled.
    See Also:
    Constant Field Values
  - PROP_BROWSER_API_HOSTS
```
public static final String PROP_BROWSER_API_HOSTS
```
    Comma-separated hosts (IPs or hostnames) allowed to use the browser API without a nonce, in addition to loopback. Ignored when PROP_BROWSER_API is false.
    See Also:
    Constant Field Values
  - PROP_CLIENT_ID
```
public static final String PROP_CLIENT_ID
```
    Client identity spoofing: empty (default) to identify as I2PSnark, "random" to pick a random known client profile per destination per run, or the name of a known client (e.g. "Vuze") to always impersonate it. Applies to the tracker peer ID and User-Agent, the BT handshake peer ID, the BEP 10 extension handshake "v" string, and webseed fetches.
    See Also:
    Constant Field Values
  - PROP_CLIENT_IDS
```
public static final String PROP_CLIENT_IDS
```
    Optional comma-separated subset of client names (see ClientID.profiles()) to choose from when PROP_CLIENT_ID is "random"; unknown names are ignored.
    See Also:
    Constant Field Values
  - PROP_COLLAPSE_PANELS
```
public static final String PROP_COLLAPSE_PANELS
```
    See Also:
    Constant Field Values
  - PROP_DEST_CYCLE
```
public static final String PROP_DEST_CYCLE
```
    Whether running torrents are periodically stopped and restarted so their destinations rotate to fresh identities, breaking long-lived linkage between the router's IP and the torrents' destinations at trackers and in the DHT. Destinations are ephemeral anyway, changing on every router restart; this extends that to within a run. The cycle is skipped while any torrent is actively downloading, and only the torrents running when the cycle fires are restarted.
    See Also:
    Constant Field Values
  - PROP_DIR
```
public static final String PROP_DIR
```
    See Also:
    Constant Field Values
  - PROP_DOWNBW_MAX
```
public static final String PROP_DOWNBW_MAX
```
    See Also:
    Constant Field Values
  - PROP_ENABLE_ADDCREATE
```
public static final String PROP_ENABLE_ADDCREATE
```
    See Also:
    Constant Field Values
  - PROP_ENABLE_LIGHTBOX
```
public static final String PROP_ENABLE_LIGHTBOX
```
    See Also:
    Constant Field Values
  - PROP_FILES_PUBLIC
```
public static final String PROP_FILES_PUBLIC
```
    See Also:
    Constant Field Values
  - PROP_I2CP_HOST
```
public static final String PROP_I2CP_HOST
```
    See Also:
    Constant Field Values
  - PROP_I2CP_OPTS
```
public static final String PROP_I2CP_OPTS
```
    See Also:
    Constant Field Values
  - PROP_I2CP_PORT
```
public static final String PROP_I2CP_PORT
```
    See Also:
    Constant Field Values
  - PROP_MAX_FILES_PER_TORRENT
```
public static final String PROP_MAX_FILES_PER_TORRENT
```
    See Also:
    Constant Field Values
  - PROP_MAX_MESSAGES
```
public static final String PROP_MAX_MESSAGES
```
    See Also:
    Constant Field Values
  - PROP_MAX_PARTSIZE
```
public static final String PROP_MAX_PARTSIZE
```
    Cap on a single piece request from a peer. @since 0.9.71+
    See Also:
    Constant Field Values
  - PROP_MAX_PIPELINE
```
public static final String PROP_MAX_PIPELINE
```
    Maximum request pipeline depth for outbound requests. @since 0.9.71+
    See Also:
    Constant Field Values
  - PROP_MIN_PIPELINE
```
public static final String PROP_MIN_PIPELINE
```
    Minimum request pipeline depth for outbound requests. @since 0.9.71+
    See Also:
    Constant Field Values
  - PROP_MULTI_DEST
```
public static final String PROP_MULTI_DEST
```
    Whether each torrent runs on its own destination.
    See Also:
    Constant Field Values
  - PROP_MULTI_DEST_MAX
```
public static final String PROP_MULTI_DEST_MAX
```
    Maximum number of destinations in multi-dest mode, 0 for one per torrent.
    See Also:
    Constant Field Values
  - PROP_OLD_AUTO_START
```
public static final String PROP_OLD_AUTO_START
```
    See Also:
    Constant Field Values
  - PROP_OPENTRACKERS
```
public static final String PROP_OPENTRACKERS
```
    See Also:
    Constant Field Values
  - PROP_PAGE_SIZE
```
public static final String PROP_PAGE_SIZE
```
    See Also:
    Constant Field Values
  - PROP_PARTSIZE
```
public static final String PROP_PARTSIZE
```
    Chunk size for outbound piece requests. @since 0.9.71+
    See Also:
    Constant Field Values
  - PROP_PREALLOCATE_FILES
```
public static final String PROP_PREALLOCATE_FILES
```
    See Also:
    Constant Field Values
  - PROP_PRIVATETRACKERS
```
public static final String PROP_PRIVATETRACKERS
```
    See Also:
    Constant Field Values
  - PROP_RANDOMIZE_STARTUP
```
public static final String PROP_RANDOMIZE_STARTUP
```
    Stagger batched starts with a random delay, so torrents that start together cannot be correlated by trackers or DHT peers, and tunnel builds are spread out. Disable to start all torrents in a batch immediately.
    See Also:
    Constant Field Values
  - PROP_REFRESH_DELAY
```
public static final String PROP_REFRESH_DELAY
```
    See Also:
    Constant Field Values
  - PROP_SHOULD_PAD_FILES
```
public static final String PROP_SHOULD_PAD_FILES
```
    Add BEP 47 padding files to new torrents.
    See Also:
    Constant Field Values
  - PROP_SHOW_STATUSFILTER
```
public static final String PROP_SHOW_STATUSFILTER
```
    See Also:
    Constant Field Values
  - PROP_STARTUP_DELAY_MAX
```
public static final String PROP_STARTUP_DELAY_MAX
```
    See Also:
    Constant Field Values
  - PROP_STARTUP_DELAY_MIN
```
public static final String PROP_STARTUP_DELAY_MIN
```
    See Also:
    Constant Field Values
  - PROP_TEMP_DIR
```
public static final String PROP_TEMP_DIR
```
    Configuration key for the staging directory where incomplete files are written until a file's pieces are all downloaded, at which point the file is copied into the data directory. Unset or empty disables the feature.
    See Also:
    Constant Field Values
  - PROP_THEME
```
public static final String PROP_THEME
```
    See Also:
    Constant Field Values
  - PROP_TORRENT_CREATE_FILTERS
```
public static final String PROP_TORRENT_CREATE_FILTERS
```
    Comma delimited list of name=filterPattern for torrent create filters. Deprecated. If detected, filters will be converted to new storage and then this config will be removed.
    See Also:
    Constant Field Values
  - PROP_TORRENT_FILTERS_CONFIG
```
public static final String PROP_TORRENT_FILTERS_CONFIG
```
    Filename for serialized torrent filters config.
    See Also:
    Constant Field Values
  - PROP_TRACKERS
```
public static final String PROP_TRACKERS
```
    Comma delimited list of name=announceURL=baseURL for the trackers to be displayed.
    See Also:
    Constant Field Values
  - PROP_UPBW_MAX
```
public static final String PROP_UPBW_MAX
```
    See Also:
    Constant Field Values
  - PROP_UPLOADERS_TOTAL
```
public static final String PROP_UPLOADERS_TOTAL
```
    See Also:
    Constant Field Values
  - PROP_VARY_INBOUND_HOPS
```
public static final String PROP_VARY_INBOUND_HOPS
```
    See Also:
    Constant Field Values
  - PROP_VARY_OUTBOUND_HOPS
```
public static final String PROP_VARY_OUTBOUND_HOPS
```
    See Also:
    Constant Field Values
  - RC_PROP_THEME
```
public static final String RC_PROP_THEME
```
    See Also:
    Constant Field Values
  - RC_PROP_UNIVERSAL_THEMING
```
public static final String RC_PROP_UNIVERSAL_THEMING
```
    See Also:
    Constant Field Values
- Constructor Detail
  - SnarkManager
```
public SnarkManager(I2PAppContext ctx)
```
    For embedded.
  - SnarkManager
```
public SnarkManager(I2PAppContext ctx,
                    String ctxPath,
                    String ctxName)
```
    For webapp.
    Parameters:
    ctxPath - generally "/i2psnark"
    ctxName - generally "i2psnark"
- Method Detail
  - addDownloader
```
public void addDownloader(Snark torrent)
```
    Add and start a FetchAndAdd task. Remove it with deleteMagnet().
    Parameters:
    torrent - must be instanceof FetchAndAdd
    Throws:
    RuntimeException - via Snark.fatal()?
  - addMagnet
```
public void addMagnet(String name,
                      byte[] ih,
                      String trackerURL,
                      boolean updateStatus)
```
    Add a torrent with the info hash alone (magnet / maggot)
    Parameters:
    name - hex or b32 name from the magnet link
    ih - 20 byte info hash
    trackerURL - may be null
    updateStatus - should we add this magnet to the config file, to save it across restarts, in case we don't get the metadata before shutdown?
    Throws:
    RuntimeException - via Snark.fatal()
  - addMagnet
```
public Snark addMagnet(String name,
                       byte[] ih,
                       String trackerURL,
                       boolean updateStatus,
                       boolean autoStart,
                       File dataDir,
                       CompleteListener listener)
```
    Add a torrent with the info hash alone (magnet / maggot) External use is for UpdateRunner.
    Parameters:
    name - hex or b32 name from the magnet link
    ih - 20 byte info hash
    trackerURL - may be null
    updateStatus - should we add this magnet to the config file, to save it across restarts, in case we don't get the metadata before shutdown?
    dataDir - must exist, or null to default to snark data directory
    listener - to intercept callbacks, should pass through to this
    Returns:
    the new Snark or null on failure
    Throws:
    RuntimeException - via Snark.fatal()
  - addMagnet
```
public void addMagnet(String name,
                      byte[] ih,
                      String trackerURL,
                      boolean updateStatus,
                      File dataDir)
```
    Add a torrent with the info hash alone (magnet / maggot)
    Parameters:
    name - hex or b32 name from the magnet link
    ih - 20 byte info hash
    trackerURL - may be null
    updateStatus - should we add this magnet to the config file, to save it across restarts, in case we don't get the metadata before shutdown?
    dataDir - must exist, or null to default to snark data directory
    Throws:
    RuntimeException - via Snark.fatal()
  - addMessage
```
public void addMessage(Snark snark,
                       String message)
```
    A Snark.CompleteListener method.
    Specified by:
    addMessage in interface CompleteListener
  - addMessage
```
public void addMessage(String message)
```
    Use if it does not include a link. Escapes '<' and '>' before queueing
  - addMessageAndPrint
```
public void addMessageAndPrint(String message)
```
    Queue a message and, when running standalone, print it to stdout.
    Parameters:
    message - the message to queue
  - addMessageAndPrint
```
public void addMessageAndPrint(String message,
                               String print)
```
    Queue a message and, when running standalone, print possibly different text to stdout.
    Parameters:
    message - the message to queue
    print - the text to print, or null for no output
  - addMessageNoEscape
```
public void addMessageNoEscape(String message)
```
    Use if it includes a link. Does not escape '<' and '>' before queueing
  - addMessageNoEscapeAndPrint
```
public void addMessageNoEscapeAndPrint(String message)
```
    Queue a message and, when running standalone, print it to stdout.
    Parameters:
    message - the message to queue
  - addMessageNoEscapeAndPrint
```
public void addMessageNoEscapeAndPrint(String message,
                                       String print)
```
    Queue a message and, when running standalone, print possibly different text to stdout.
    Parameters:
    message - the message to queue
    print - the text to print, or null for no output
  - addTorrent
```
public boolean addTorrent(MetaInfo metainfo,
                          BitField bitfield,
                          String filename,
                          File baseFile,
                          boolean dontAutoStart)
                   throws IOException
```
    Add a torrent from a MetaInfo. Save the MetaInfo data to filename. Serialized on the add lock to prevent interference from the DirMonitor. This verifies that a torrent with this infohash is not already added. This may take a LONG time to create or check the storage, so the global snarks lock is only held for the duplicate checks.
    Called from servlet. This is only for the 'create torrent' form.
    Parameters:
    metainfo - the metainfo for the torrent
    bitfield - the current completion status of the torrent, or null
    filename - the absolute path to save the metainfo to, generally ending in ".torrent", which is also the name of the torrent Must be a filesystem-safe name. If null, will generate a name from the metainfo.
    baseFile - may be null, if so look in rootDataDir
    Returns:
    success
    Throws:
    RuntimeException - via Snark.fatal()
    IOException
  - areFilesPublic
```
public boolean areFilesPublic()
```
    Whether the files in the data directory are world-readable.
    Returns:
    default false
  - browserApiEnabled
```
public boolean browserApiEnabled()
```
    Whether the nonce-free browser API for adding torrents is enabled.
  - clearMessages
```
public void clearMessages()
```
  - clearMessages
```
public void clearMessages(int id)
```
    Clear through this id
  - copyAndAddTorrent
```
public boolean copyAndAddTorrent(File fromfile,
                                 String filename,
                                 File dataDir)
                          throws IOException
```
    Add a torrent from a file not in the torrent directory. Copy the file to filename. Holds the snarks lock to prevent interference from the DirMonitor. Caller must verify this torrent is not already added. This may take a LONG time to create or check the storage.
    Parameters:
    fromfile - where the file is now, presumably in a temp directory somewhere
    filename - the absolute path to save the metainfo to, generally ending in ".torrent", which is also the name of the torrent Must be a filesystem-safe name.
    dataDir - must exist, or null to default to snark data directory
    Returns:
    success
    Throws:
    RuntimeException - via Snark.fatal()
    IOException
  - countRealFiles
```
static int countRealFiles(List<List<String>> files)
```
    Count the files in a metainfo file list for the max files per torrent check, excluding BEP 47 padding files (.pad) and parse-renamed padding (_pad); a padded torrent must not be rejected because of its synthetic zero files. Padding is only recognized at the top level, matching the BEP 47 layout and Storage's create-side handling.
    Parameters:
    files - from MetaInfo.getFiles(), may be null
    Returns:
    the number of non-padding files
  - deleteMagnet
```
public void deleteMagnet(Snark snark)
```
    Stop and delete a torrent running in magnet mode
    Parameters:
    snark - a torrent with a fake file name ("Magnet xxxx")
  - escapeMessage
```
public static String escapeMessage(String message)
```
    Escape a message for HTML display, preserving intentional ' ' spacers. Order matters: '&' first so the later entity-escapes of '<' and '>' are not undone, and restore the literal ' ' entries afterwards.
    Parameters:
    message - the raw message text, not null
    Returns:
    the message with HTML metacharacters escaped
  - fatal
```
public void fatal(Snark snark,
                  String error)
```
    A Snark.CompleteListener method.
    Specified by:
    fatal in interface CompleteListener
  - getBandwidthListener
```
public BandwidthListener getBandwidthListener()
```
    The bandwidth listener for this manager.
    Specified by:
    getBandwidthListener in interface CompleteListener
    Returns:
    bandwidth listener
  - getBrowserApiHosts
```
public String getBrowserApiHosts()
```
    The raw comma-separated browser API allowed hosts config, for the config form.
    Returns:
    non-null, may be empty
  - getConfigDir
```
public File getConfigDir()
```
    For RPC
    Returns:
    the config dir
  - getCreateFilterCount
```
public int getCreateFilterCount()
```
    Returns the current number of configured file filters
    Returns:
    the create filter count
  - getDataDir
```
public File getDataDir()
```
    The configured torrent data directory.
    Returns:
    the configured torrent data directory
  - getDiskUsage
```
public String getDiskUsage()
```
    The cached disk usage string for display.
    Returns:
    the disk usage
  - getDisplayName
```
public String getDisplayName()
```
    ClientApp method.
    Specified by:
    getDisplayName in interface ClientApp
    Returns:
    the display name
  - getMaxFilesPerTorrent
```
public int getMaxFilesPerTorrent()
```
    Maximum number of files a torrent may contain.
    Returns:
    the max files per torrent
  - getMaxLogMessages
```
public int getMaxLogMessages()
```
    Maximum number of messages kept for display on the web page.
    Returns:
    the max log messages
  - getMessages
```
public List<UIMessages.Message> getMessages()
```
    The list of recent UI messages for display on the web page.
    Returns:
    list of recent messages
  - getName
```
public String getName()
```
    ClientApp method.
    Specified by:
    getName in interface ClientApp
    Returns:
    the name
  - getPageSize
```
public int getPageSize()
```
    For GUI
    Returns:
    the page size
  - getPrivateTrackers
```
public List<String> getPrivateTrackers()
```
    The configured private tracker list.
    Returns:
    non-null, fixed size, may be empty or unmodifiable
  - getRandomizeStartupDelay
```
public boolean getRandomizeStartupDelay()
```
    Whether batched torrent starts are staggered with a random delay, so torrents starting together cannot be correlated, and tunnel builds are spread out.
    Returns:
    true to stagger batched starts (default)
  - getRefreshDelaySeconds
```
public int getRefreshDelaySeconds()
```
    How often the web page refreshes itself.
    Returns:
    -1 for never
  - getSavedAddedAndCompleted
```
public long[] getSavedAddedAndCompleted(Snark snark)
```
    Setting for a torrent from the config file.
    Returns:
    non-null, rv[0] is added time or 0; rv[1] is completed time or 0
  - getSavedComments
```
public CommentSet getSavedComments(Snark snark)
```
    The comments for a torrent
    Specified by:
    getSavedComments in interface CompleteListener
    Returns:
    null if none
  - getSavedCommentsEnabled
```
public boolean getSavedCommentsEnabled(Snark snark)
```
    Setting for comments enabled from the config file. Caller must first check global I2PSnarkUtil.commentsEnabled() Default true.
    Returns:
    the saved comments enabled
  - getSavedPreserveNamesSetting
```
public boolean getSavedPreserveNamesSetting(Snark snark)
```
    Setting for a torrent from the config file.
    Specified by:
    getSavedPreserveNamesSetting in interface CompleteListener
    Returns:
    setting, false if not found
  - getSavedTorrentBitField
```
public BitField getSavedTorrentBitField(Snark snark)
```
    Saved bitfield for a torrent from the config file. Convert "." to a full bitfield. A Snark.CompleteListener method.
    Specified by:
    getSavedTorrentBitField in interface CompleteListener
    Parameters:
    snark - the Snark instance
    Returns:
    the saved torrent bit field
  - getSavedTorrentTime
```
public long getSavedTorrentTime(Snark snark)
```
    Timestamp for a torrent from the config file. A Snark.CompleteListener method.
    Specified by:
    getSavedTorrentTime in interface CompleteListener
    Parameters:
    snark - the Snark instance
    Returns:
    the saved torrent time in milliseconds
  - getSavedUploaded
```
public long getSavedUploaded(Snark snark)
```
    Setting for a torrent from the config file.
    Specified by:
    getSavedUploaded in interface CompleteListener
    Returns:
    setting, 0 if not found
  - getSortedTorrentCreateFilterStrings
```
public List<TorrentCreateFilter> getSortedTorrentCreateFilterStrings()
```
    Sorted copy
    Returns:
    the sorted torrent create filter strings
  - getSortedTrackers
```
public List<Tracker> getSortedTrackers()
```
    Sorted copy
    Returns:
    the sorted trackers
  - getState
```
public ClientAppState getState()
```
    ClientApp method. Doesn't matter, we are only registering.
    Specified by:
    getState in interface ClientApp
    Returns:
    INITIALIZED always.
  - getTheme
```
public String getTheme()
```
    The current theme for this web interface.
    Returns:
    String -- the current theme
  - getThemes
```
public String[] getThemes()
```
    All themes available for this web interface.
    Returns:
    String[] -- Array of all the themes found, non-null, unsorted
  - getTime
```
public String getTime()
```
  - getTorrent
```
public Snark getTorrent(String filename)
```
    Grab the torrent given the (canonical) filename of the .torrent file
    Returns:
    Snark or null
  - getTorrentByBaseName
```
public Snark getTorrentByBaseName(String filename)
```
    Grab the torrent given the base name of the storage
    Parameters:
    filename - must be the filtered name, which may be different than the metainfo's name
    Returns:
    Snark or null
  - getTorrentByInfoHash
```
public Snark getTorrentByInfoHash(byte[] infohash)
```
    Grab the torrent given the info hash
    Returns:
    Snark or null
  - getTorrentCreateFilterMap
```
public Map<String,TorrentCreateFilter> getTorrentCreateFilterMap()
```
    Unsorted map of name to TorrentCreateFilter object Modifiable, not a copy
    Returns:
    the torrent create filter map
  - getTorrentCreateFilterStrings
```
public Collection<TorrentCreateFilter> getTorrentCreateFilterStrings()
```
    Unsorted, do not modify
    Returns:
    the torrent create filter strings
  - getTorrents
```
public Collection<Snark> getTorrents()
```
    Unmodifiable
    Returns:
    the torrents
  - getTrackerMap
```
public Map<String,Tracker> getTrackerMap()
```
    Unsorted map of name to Tracker object Modifiable, not a copy
    Returns:
    the tracker map
  - getTrackers
```
public Collection<Tracker> getTrackers()
```
    Unsorted, do not modify
  - getUniversalTheming
```
public boolean getUniversalTheming()
```
    Whether themes are applied across all applications.
    Returns:
    the universal theming
  - gotMetaInfo
```
public String gotMetaInfo(Snark snark)
```
    We transitioned from magnet mode, we have now initialized our metainfo and storage. The listener should now call getMetaInfo() and save the data to disk. A Snark.CompleteListener method.
    Specified by:
    gotMetaInfo in interface CompleteListener
    Returns:
    the new name for the torrent or null on error
  - gotPiece
```
public void gotPiece(Snark snark)
```
    A Snark.CompleteListener method.
    Specified by:
    gotPiece in interface CompleteListener
  - hasModifiedTrackers
```
public boolean hasModifiedTrackers()
```
    Has the default tracker list been modified?
    Returns:
    whether modified trackers is present
  - isBrowserApiHost
```
public boolean isBrowserApiHost(String host)
```
    Whether the given remote address may use the browser API without a nonce. Loopback is always allowed; otherwise the host must be listed in the PROP_BROWSER_API_HOSTS config. Does not check the enable flag.
    Parameters:
    host - remote address string from the request
    Returns:
    whether allowed
  - isCollapsePanelsEnabled
```
public boolean isCollapsePanelsEnabled()
```
    Whether the web interface collapses panels by default.
    Returns:
    default true
  - isEnableLightbox
```
public boolean isEnableLightbox()
```
    Whether the lightbox is used to display large images in the web interface.
    Returns:
    default true
  - isLoopbackHost
```
public static boolean isLoopbackHost(String host)
```
    IPv4 loopback (127/8), IPv6 loopback, and "localhost".
  - isShowStatusFilter
```
public boolean isShowStatusFilter()
```
    Whether the status filter bar is shown in the web interface.
    Returns:
    default false
  - isSmartSortEnabled
```
public boolean isSmartSortEnabled()
```
    Whether smart sort is enabled in the web interface.
    Returns:
    default false
  - isStopping
```
public boolean isStopping()
```
    Whether the manager is in the process of stopping.
    Returns:
    whether stopping
  - isVaryInboundHops
```
public boolean isVaryInboundHops()
```
    Whether hops are randomly varied for inbound torrent tunnels.
    Returns:
    default false
  - isVaryOutboundHops
```
public boolean isVaryOutboundHops()
```
    Whether hops are randomly varied for outbound torrent tunnels.
    Returns:
    default false
  - listTorrentFiles
```
public Set<String> listTorrentFiles()
```
    Canonical .torrent filenames that we are dealing with. An unsynchronized copy.
  - loadConfig
```
public void loadConfig(String filename)
```
    Load the config from the given file.
    Parameters:
    filename - null to set initial defaults
  - loadSavedFilePriorities
```
public void loadSavedFilePriorities(Snark snark)
```
    Saved priorities for a torrent from the config file.
  - locked_saveComments
```
public void locked_saveComments(Snark snark,
                                CommentSet comments)
```
    Save the comments for a torrent Caller must synchronize on comments.
    Specified by:
    locked_saveComments in interface CompleteListener
    Parameters:
    comments - non-null
  - parseShouldPadFiles
```
static boolean parseShouldPadFiles(Properties props)
```
    Parses the PROP_SHOULD_PAD_FILES value from the given properties, applying the default when absent or unparsable.
    Parameters:
    props - the config properties
    Returns:
    whether BEP 47 padding files are added to new torrents
  - recheckTorrent
```
public void recheckTorrent(Snark snark)
```
    Threaded. Torrent must be stopped.
  - removeMagnetStatus
```
public void removeMagnetStatus(byte[] ih)
```
    Remove the magnet marker from the config file.
  - removeTorrent
```
public void removeTorrent(String filename)
```
    Stop the torrent and delete the torrent file itself, but leaving the data behind. Removes saved config file also. Holds the snarks lock to prevent interference from the DirMonitor.
  - resolveBrowserApiHosts
```
public static Set<InetAddress> resolveBrowserApiHosts(String hosts)
```
    Parse a comma-separated host list into resolved addresses. Unresolvable or malformed entries are skipped; loopback entries are redundant (always allowed) and skipped.
    Parameters:
    hosts - comma-separated hostnames or IPs, may be null
    Returns:
    non-null set of resolved addresses, may be empty
  - saveConfig
```
public void saveConfig()
```
  - saveMagnetStatus
```
public void saveMagnetStatus(byte[] ih,
                             String dir,
                             String trackerURL,
                             String dn)
```
    Just remember we have it. This used to simply store a line in the config file, but now we also save it in its own config file, just like other torrents, so we can remember the directory, tracker, etc.
    Parameters:
    dir - may be null
    trackerURL - may be null
    dn - may be null
  - saveOpenTrackers
```
public void saveOpenTrackers(List<String> ot)
```
    Save the given open tracker list.
    Parameters:
    ot - null to restore default
  - savePrivateTrackers
```
public void savePrivateTrackers(List<String> pt)
```
    Save the given private tracker list.
    Parameters:
    pt - null ok, default is none
  - saveTorrentCreateFilterMap
```
public void saveTorrentCreateFilterMap()
```
  - saveTorrentStatus
```
public void saveTorrentStatus(Snark snark)
```
    Save the completion status of a torrent and other data in the config file for that torrent. Does nothing for magnets.
  - saveTrackerMap
```
public void saveTrackerMap()
```
  - sessionDisconnected
```
public void sessionDisconnected()
```
    DisconnectListener interface
    Specified by:
    sessionDisconnected in interface I2PSocketManager.DisconnectListener
  - setAPI
```
public void setAPI(String target,
                   String key)
```
    Set and persist the API key for remote access, mirroring the apiKey/apiTarget handling in updateConfig. Empty key clears nothing (existing behavior).
    Parameters:
    target - the API target base path
    key - the API key
  - setBrowserApi
```
public void setBrowserApi(boolean enable,
                          String hosts)
```
    Set and persist the browser API enable flag and allowed hosts list. The change takes effect immediately; no restart required.
    Parameters:
    enable - whether the browser API is enabled at all
    hosts - comma-separated hostnames or IPs, may be null/empty
  - setDefaultTorrentCreateFilterMap
```
public void setDefaultTorrentCreateFilterMap()
```
  - setDefaultTrackerMap
```
public void setDefaultTrackerMap()
```
  - setSavedCommentsEnabled
```
public void setSavedCommentsEnabled(Snark snark,
                                    boolean yes)
```
    Setting for comments enabled in the config file.
  - shouldAutoStart
```
public boolean shouldAutoStart()
```
    Whether newly added torrents should be started automatically.
    Specified by:
    shouldAutoStart in interface CompleteListener
    Returns:
    true if newly added torrents should be started automatically
  - shouldDestCycle
```
public boolean shouldDestCycle()
```
    Whether running torrents are periodically restarted with fresh destinations.
    Returns:
    true to cycle destinations (default)
  - shouldPreallocateFiles
```
public boolean shouldPreallocateFiles()
```
    Whether new torrents preallocate their storage files.
    Returns:
    default true
  - shutdown
```
public void shutdown(String[] args)
```
    ClientApp method. Does nothing. Doesn't matter, we are only registering.
    Specified by:
    shutdown in interface ClientApp
    Parameters:
    args - generally null but could be stopArgs from clients.config
  - start
```
public void start()
```
    Caller _must_ call loadConfig(file) before this if setting new values for i2cp host/port or i2psnark.dir
  - startAllTorrents
```
public void startAllTorrents()
```
    Always thread it
  - startDelay
```
static long startDelay(Random rnd)
```
    Random delay between auto-started torrents in multi-dest mode, 30-90 seconds.
    Parameters:
    rnd - source of randomness
    Returns:
    delay in milliseconds
  - startTorrent
```
public void startTorrent(byte[] infoHash)
```
    If not connected, thread it, otherwise inline
    Throws:
    RuntimeException - via Snark.fatal()
  - startTorrent
```
public void startTorrent(Snark snark)
```
    If not connected, thread it, otherwise inline
    Throws:
    RuntimeException - via Snark.fatal()
  - startup
```
public void startup()
```
    ClientApp method. Does nothing. Doesn't matter, we are only registering.
    Specified by:
    startup in interface ClientApp
  - stop
```
public void stop()
```
    Called by the webapp at Jetty shutdown. Stops all torrents. Does not close the tunnel, so the announces have a chance. Fix this so an individual webapp stop will close the tunnel. Runs inline.
  - stopAllTorrents
```
public void stopAllTorrents(boolean finalShutdown)
```
    Stop all running torrents, and close the tunnel after a delay to allow for announces. If called at router shutdown via Jetty shutdown hook -> webapp destroy() -> stop(), the tunnel won't actually be closed as the SimpleTimer2 is already shutdown or will be soon, so we delay a few seconds inline.
    Parameters:
    finalShutdown - if true, sleep at the end if any torrents were running
  - stopTorrent
```
public void stopTorrent(Snark torrent)
```
    Stop the torrent only, leaving it on the list of torrents.
  - stopTorrent
```
public void stopTorrent(Snark torrent,
                        boolean shouldRemove)
```
    Stop the torrent, leaving it on the list of torrents unless told to remove it. If shouldRemove is true, removes the config file also.
  - stopTorrent
```
public Snark stopTorrent(String filename,
                         boolean shouldRemove)
```
    Stop the torrent, leaving it on the list of torrents unless told to remove it. If shouldRemove is true, removes the config file also.
  - torrentComplete
```
public void torrentComplete(Snark snark)
```
    A Snark.CompleteListener method.
    Specified by:
    torrentComplete in interface CompleteListener
    Parameters:
    snark - the Snark instance that completed
  - updateConfig
```
public void updateConfig(String dataDir,
                         boolean filesPublic,
                         boolean autoStart,
                         String refreshDelay,
                         String startDelayMin,
                         String startDelayMax,
                         String pageSize,
                         String seedPct,
                         String eepHost,
                         String eepPort,
                         String i2cpHost,
                         String i2cpPort,
                         String i2cpOpts,
                         String upLimit,
                         String upBW,
                         String downBW,
                         boolean useOpenTrackers,
                         boolean useDHT,
                         String theme,
                         String lang,
                         boolean enableRatings,
                         boolean enableComments,
                         String commentName,
                         boolean collapsePanels,
                         boolean showStatusFilter,
                         boolean enableLightbox,
                         boolean enableAddCreate,
                         boolean enableVaryInboundHops,
                         boolean enableVaryOutboundHops,
                         boolean multiDest,
                         String multiDestMax,
                         boolean randomizeStartup,
                         String apiTarget,
                         String apiKey,
                         String maxFiles,
                         boolean preallocateFiles,
                         String tempDir)
```
    All params may be null or need trimming.
  - updateStatus
```
public void updateStatus(Snark snark)
```
    A Snark.CompleteListener method.
    Specified by:
    updateStatus in interface CompleteListener
    Parameters:
    snark - the Snark instance to update status for
  - util
```
public I2PSnarkUtil util()
```
    The I2PSnarkUtil instance for this manager.
    Returns:
    I2PSnarkUtil instance

Class SnarkManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CONFIG_DIR_SUFFIX

CONFIG_FILE

DEFAULT_BACKUP_TRACKER

DEFAULT_BAN_DISCARD_PERIOD

DEFAULT_BAN_DISCARD_RATIO

DEFAULT_ENABLE_ADDCREATE

DEFAULT_ENABLE_LIGHTBOX

DEFAULT_MAX_FILES_PER_TORRENT

DEFAULT_MAX_UP_BW

DEFAULT_MULTI_DEST_MAX

DEFAULT_PREALLOCATE_FILES

DEFAULT_REFRESH_DELAY_SECS

DEFAULT_SHOULD_PAD_FILES

DEFAULT_SHOW_STATUSFILTER

DEFAULT_STARTUP_DELAY_MAX

DEFAULT_STARTUP_DELAY_MIN

DEFAULT_THEME

DEFAULT_TRACKER_ANNOUNCES

DEFAULT_TUNNEL_QUANTITY

KNOWN_OPENTRACKERS

MAX_MULTI_DEST

MIN_DOWN_BW

MIN_UP_BW

PROP_AUTO_START

PROP_BAN_DISCARD_PERIOD

PROP_BAN_DISCARD_RATIO

PROP_BROWSER_API

PROP_BROWSER_API_HOSTS

PROP_CLIENT_ID

PROP_CLIENT_IDS

PROP_COLLAPSE_PANELS

PROP_DEST_CYCLE

PROP_DIR

PROP_DOWNBW_MAX

PROP_ENABLE_ADDCREATE

PROP_ENABLE_LIGHTBOX

PROP_FILES_PUBLIC

PROP_I2CP_HOST

PROP_I2CP_OPTS

PROP_I2CP_PORT

PROP_MAX_FILES_PER_TORRENT

PROP_MAX_MESSAGES

PROP_MAX_PARTSIZE

PROP_MAX_PIPELINE

PROP_MIN_PIPELINE

PROP_MULTI_DEST

PROP_MULTI_DEST_MAX

PROP_OLD_AUTO_START

PROP_OPENTRACKERS

PROP_PAGE_SIZE

PROP_PARTSIZE

PROP_PREALLOCATE_FILES

PROP_PRIVATETRACKERS

PROP_RANDOMIZE_STARTUP

PROP_REFRESH_DELAY

PROP_SHOULD_PAD_FILES

PROP_SHOW_STATUSFILTER

PROP_STARTUP_DELAY_MAX

PROP_STARTUP_DELAY_MIN

PROP_TEMP_DIR

PROP_THEME

PROP_TORRENT_CREATE_FILTERS

PROP_TORRENT_FILTERS_CONFIG

PROP_TRACKERS

PROP_UPBW_MAX

PROP_UPLOADERS_TOTAL

PROP_VARY_INBOUND_HOPS

PROP_VARY_OUTBOUND_HOPS

RC_PROP_THEME

RC_PROP_UNIVERSAL_THEMING

Constructor Detail

SnarkManager

SnarkManager

Method Detail