Skip to content
Alexandru Branza edited this page Jul 29, 2018 · 18 revisions

Guide for using Powder Web. (work in progress)

Jump to Topic


Introduction

When you run Powder Web you actually run a web server locally that allows the management and streaming of torrents from any browser, on any device. When Powder Web is running you can visit http://localhost:3000/ (unless it was changed in the settings) in your browser to access the Powder Web.

Typically, when accessing Powder Web from the browser for the first time, you will see a login prompt.

Creating a User

In order to create a user you will need to open Powder Web by right clicking the tray icon, selecting "Open App" or "Open in Browser" and setting the "Allowed Users" setting to "1" from the "Web Server" settings in the Settings Panel. (gear icon, upper right corner of UI)

If you visit http://localhost:3000/ again now, you will have access to registering 1 user. During registration, you will not receive any email notification from the service.

How can I use this on my LAN from any device?

Locally, you can access Powder Web with http://localhost:3000/ in any browser. To use it through the LAN, on any device, you will need to locate your LAN IP and substitute localhost from http://localhost:3000/ with your LAN IP, then using the new URL in any browser from a device connected to the same local network.

How can I use this on the Internet from any device?

In this case you will need to identify your Internet IP (you can see your IP here), then opening your router's settings under Port Forwarding and allowing the 3000 port from your LAN IP to be visible to the internet.

After doing this, you can substitute localhost from http://localhost:3000/ with your Internet IP, then using the new URL in any browser of any device connected to the internet.

Using a Domain

If you prefer using an easier to remember domain name instead (for example: http://torrents.hopto.org/, etc), you can visit https://www.noip.com/, sign up for a free account, and use their Redirect feature to redirect to the aforementioned internet URL.


Torrents

Be mindful when using torrents, using them is considered illegal in some countries and you could get finned for using this technology.

Fastest Way to Start Playback for Torrents

Powder Web is made to support the web, it's also made to stream torrents to your browser. But the fastest way to start torrent playback is to use a local video player (whichever video player you wish).

This is because streaming to your browser includes additional tasks that take time, while streaming to a normal video player is done with minimal (and fast) tasks.

To make Powder Web's Play Buttons always start with a local video player instead of the web player go to the Settings Panel and set "Play Button" under "User Interface" to "Download Playlist" instead of "Web Player".

You can use a local video player on any device. (either phone, tablet, PC, etc)

Another important tip to speeding up torrent play time is to associate Powder Web with magnet links or torrent files. You can do this from "Associations" in the Settings Panel.

It is also recommended to activate "Run on Start-Up" from the Tray Icon right click menu. This leads to better seeding ratios and also speeds up torrent play times by not having to wait for the app to load when running from file / magnet link associations. (as application loading was done on system start)

Private Torrent Trackers

Most private torrent websites have a whitelist (others have a blacklist) of torrent clients that are allowed to use them or not. Powder Web is a new torrent client, although it seeds well and protects against torrent poisoning, which should get it whitelisted on private torrent websites when and if it will is something that we can't predict.

Until it gets famous enough to be considered to be taken into account by private trackers, users can spoof their Peer ID from the Settings Panel to mimic a different torrent client.

For example: setting the Peer ID to "UT3530" tells trackers that you're using uTorrent v3.5.3, which IS whitelisted by one private tracker that I know and thus downloads the torrent successfully.

Please be sure to check the websites whitelist or blacklist, which is usually visible in the footer of the website.

Setting Torrent Folder Permissions

When using Powder Web in combination with other applications (like Plex, for example), the second application might not have access to the torrent folders (to delete them, for example) on the user's request. This is a common case on Linux / OSX. In this case you can set user defined commands to run when the torrent finishes. (by using the "Set Commands" under "Commands to Run When Torrent Finished" in the Settings Panel)

Setting the chmod 775 %folder% command should change the permissions of all the torrent download folders so other applications can have access to the folders too. You can set more commands if you want to and separate these commands with ;; (double semicolon)

Auto-Removing Torrents

You can set the "Always Delete Inactive" under "Clean Up" in the Settings Panel to "True". All files associated with torrents that are paused will be removed. Torrents are also periodically paused automatically based on the set "Concurrent Downloads" Settings.


Speed Management

What does the Force Download action do?

The "Force Download" action will clear the peer blacklist and attempt to reconnect to all known peers. This will give your torrent download the best chances it can have for a fast download. There is also a Forced Download setting in the Setting Menu that will use this action periodically to speed up torrents.

Can I set a maximum download speed for torrent downloads?

Yes, there is a "Speed Limit" setting in the Settings Panel under the "Torrent Engine". The speed limit is applied per torrent, not to the totality of their download speed.


Subtitles

Subtitles are gotten from Open Subtitles.

Web Player Subtitles

The subtitles are loaded automatically when using the Web Player. Auto-searching for subtitles in the Web Player can be disabled from the Settings Panel.

Downloading Subtitles

If you wish to use subtitles with other video players, you will need to click the Menu Button on a Torrent File, this will bring up a menu that includes "Find Subtitles". Pressing the button will lead to a list of subtitles by country, clicking on a country will open a folder with the subtitle file in it (if Powder Web was loaded locally) or download the subtitle. (if Powder Web is loaded from the LAN or Internet)


Web Player

Hotkeys

All Web Player hotkeys are documented here.

Default Quality

You can set "Video Quality" under "Web Player" in the Settings Panel. The options are either "Maximum" or "Auto". "Maximum" will obviously always use the maximum quality, "Auto" uses 360p or closest to it as that is presumably a viewable quality and uses low bandwidth which is ok for 4G use too on mobile devices.

In-Player Settings

The Web Player has a very diverse list of settings for user enjoyment. Current settings include: playlist, searches for subtitles automatically, add local subtitle file, quality selection, playback speed, aspect ratio, crop, zoom, subtitle delay, audio delay, hotkeys.


Issues

Please write issues here. Writing and commenting on issues requires a GitHub account.

Torrent not Starting

This is mostly likely a case in which a private torrent website was used. Read the Private Torrent Trackers for a solution on using such trackers.

Web Player not Starting

This can happen for slow torrents. Alternatively, if no torrents ever play in the Web Player, you should try setting "Browser Support" to "Maximum" in the Settings Panel. This will increase the normal time it takes the Web Player to start because instead of choosing a presumed video type for the player, we instead use all possible video sources it could support. This should guarantee playback in your browser. This option might require restarting the application to take effect.

Web Player Timestamp Wrong After Seeking

This should not normally happen, but in the off chance that it does happen in your browser, try setting the "Preserve Timestamp" setting to "Always" in the Settings Panel. This option might require restarting the application to take effect.

Use Local Video Player Instead of Web Player

Read Fastest Way to Play Torrents for an explanation of how to use a local video player instead of the Web Player.

Clone this wiki locally