Trouble-Shooting Guide¶
Reporting Problems¶
If you have any trouble during rtorrent-ps installation and configuration,
join the pyroscope-users mailing list or the inofficial ##rtorrent
channel on
irc.freenode.net
. IRC will generally provide a faster resolution.
If you are sure there is a bug, then open an issue on GitHub. Report any problems that are clearly rooted in the rTorrent core to the upstream issue tracker.
Make sure that nobody else reported the same problem before you, there is a search box you can use (after the Filters button). Please note that the GitHub issue tracker is not a support platform, use the mailing list or IRC for that.
Note
Please describe your problem clearly, and provide any pertinent information. What are the version numbers of software and OS? What did you do? What was the unexpected result? If things worked and ‘suddenly’ broke, what did you change?
On IRC, don’t ask if somebody is there, just describe your problem. Eventually, someone will notice you – IRC is a global medium, and people do live in different time zones than you.
Put up any logs on 0bin or any other pastebin service, and make sure you removed any personal information you don’t want to be publically known. Copy the pastebin link into IRC or into your post.
Common Problems & Solutions¶
Please open an issue on GitHub if you think that you have a problem that happens a lot, or you know several other people have the same problem, and it’s not already mentioned below.
Error in option file: …/05-rt-ps-columns.rc:…: Invalid key¶
You combined a brand-new pimp-my-box configuration with an older version of rTorrent-PS.
Solution ♯1 (preferred)
Update to a recent build rTorrent-PS.
Also make sure your ~/rtorrent/rtorrent.rc
is the newest one with the line…
method.insert = pyro.extended, const|value, (system.has, rtorrent-ps)
This auto-detects the presence of rTorrent-PS, but only works with builds from June 2018 onwards.
Solution ♯2
Replace this line in ~/rtorrent/rtorrent.rc
…
method.insert = pyro.extended, const|value, (system.has, rtorrent-ps)
with that one…
method.insert = pyro.extended, const|value, 1
Startup Failure: ‘your terminal only supports 8 colors’¶
See the Setup & Configuration chapter for detailed help on proper terminal setup.
If all else fails or you’re in a rush, you can switch to the 8-color theme
by calling the echo
command as shown and then start rTorrent-PS again:
echo default-8 >~/.pyroscope/color-schemes/.current
~/rtorrent/start
If you don’t use the standard configuration (where theme support comes from),
then add the ui.color.*
commands from this configuration snippet to rtorrent.rc
,
which does the same thing.