Official Documentation...

[ Table of Contents ]

APPENDIX: Online vs. Local File/Folder Locations

When specifying file locations within your configuration, header, footer and stylesheet documents; it is important to differentiate between online and local file locations.

On computers running Windows, file paths typically use a backward slash (backslash \ ) to represent subfolders. Computers running Linux/Unix typically use a forward slash (usually called "slash" / ) to represent subfolders. In BNBT's configuration, it is suggested that you use forwards slashes without regard to your operating system. Forward slashes will work for computers running Windows.

Local File/Folder Locations

The following locations are for folders stored locally on your computer and should be referenced using a local and relative path:

• Allowed Directory

— specifies the path to the directory/folder in which authorized torrent files reside.

allowed_dir = torrents

• File Directory

— specifies the path to the directory/folder which serves as the root directory for the tracker's built-in file server.

bnbt_file_dir = files

• Access Log Directory

— specifies the path to the directory/folder in which tracker access logs are stored. (disabled and left blank by default)

bnbt_access_log_dir = tracker_logs

• Error Log Directory

— specifies the path to the directory/folder in which tracker error logs are stored. (disabled and left blank by default)

bnbt_error_log_dir = tracker_logs

• Upload Directory

— specifies the path to the directory/folder in which uploaded torrents are saved; almost always should be identical to the value of the Allowed Directory.

bnbt_upload_dir = torrents

• Archive Directory

— specifies the path to the directory/folder to which deleted torrents are moved. (disabled and left blank by default)

bnbt_archive_dir = torrents_deleted

The following locations are for files stored locally on your computer and should be referenced using a local and relative path:

• Tag File

— specifies a database file that stores information regarding the torrents tracked by your tracker.

bnbt_tag_file = db/tags.bnbt

• dFile (dState File)

— specifies a database file that stores status information regarding the torrents tracked by your tracker.

dfile = db/dstate.bnbt

• Comments File

— specifies a database file that stores the posted user comments for the torrent tracked by your tracker.

bnbt_comments_file = db/comments.bnbt

• User Database File

— specifies a database file that contains the usernames, encoded passwords and permission levels for the registered users of your tracker.

bnbt_users_file = db/users.bnbt

• Dump XML File

— specifies the name and location of an XML file, in which tracker and torrent statistics are saved. This file can then be integrated into a webpage using an XML parse script.

bnbt_dump_xml_file = files/filedump.xml

• Static Header

— specifies an HTML file to be rendered above the torrent table and below the Navigation Bar on your tracker's index page.

bnbt_static_header = files/html/header.html

• Static Footer

— specifies an HTML file to be rendered below the torrent table on your tracker's index page.

bnbt_static_footer = files/html/footer.html

Online File/Folder Locations

The following locations are for files and folders stored locally on your computer and should be referenced using an online location which is relative to your tracker's URL and must begin with a leading slash:

• Style Sheet

— specifies an external cascading stylesheet to be used for all webpages generated by the tracker.

bnbt_style_sheet = /files/css/bluesteel-3.css

• Image Bar Fill

— specifies an image file (usually 1 pixel squared) to use as the color for filled portions of progress bars displayed by your tracker.

image_bar_fill = /files/images/fillbars/blue/imagebarfill.jpg

• Image Bar Trans

— specifies an image file (usually 1 pixel squared) to use as the color for the unfilled portions of progress bars displayed by your tracker.

image_bar_trans = /files/images/fillbars/blue/imagebartrans.jpg

• External Torrent Directory

— specifies an external URL where copies of the torrents tracked by your tracker are stored. This value is typically an absolute URL and will begin with http://; Please read the Appendix section regarding the ETD before enabling this feature. The majority of tracker administrators do not use the ETD. (disabled and left blank by default)

bnbt_external_torrent_dir = http://someother.domain.com/path.to.torrents/

• Images displayed on your tracker's static pages

When specifying the locations of images placed with an <img> tag, you should store these files within the tracker's file server folder structure and reference them using a relative and online location.

<img src="/files/images/imageFileName.gif">