HACK: How to change the location of your FrostWire settings folder

Screen Shot 2013-07-31 at 3.31.24 PM

This post is for advanced users who might not be happy with the default location of the FrostWire configuration folder (as of this generation of frostwire it’s called “.frostwire5” and it resides somewhere on your home folder since FrostWire will create it the first time it runs)

Maybe you don’t like folders on your home folder, maybe you keep all your configuration folders elsewhere, maybe you want to install FrostWire and keep it running on a external drive or USB stick, we’ve coded this just for you.

the “.meta” file

You will need to create a new file called “.meta” and place it next to your FrostWire executable wherever it may be.

For Windows users, this has to be on the same folder as in FrostWire.exe exists.

For Mac users, this will be inside “FrostWire.app/Contents/MacOS/” wherever your FrostWire.app may be.

For Linux users, this will be wherever your frostwire.sh and frostwire.jar files may be, in Ubuntu the default location is /usr/share/frostwire

Here’s an example of how that might look for an external drive:


#FrostWire .meta configuration file example (works only after FrostWire 5.6.3)
#meta settings for windows
user.settings.dir.windows=e:\configurations\.frostwire5.windows
user.settings.root_folder.windows=e:\Downloads

#meta settings for mac osx
user.settings.dir.mac=/Volumes/MyExternalDriveName/configurations/.frostwire5.mac
user.settings.root_folder.mac=/Volumes/MyExternalDriveName/Downloads

#meta settings for linux/unix
user.settings.dir.posix=/media/MyExternalDriveName/configurations/.frostwire5.posix
user.settings.root_folder.posix=/media/MyExternalDriveName/Downloads


NOTICE 1: Notice how we’ve created different setting folder locations for each operating system. If you want to avoid conflicts and “Data file missing” errors with your ongoing downloads, you might want to keep separate configurations for different operating systems (if you’re running frostwire off a removable disk for example).
Update (Sep 22th 2013) After FrostWire 5.6.5 you will be able to share the same settings directory for all operating systems, no more issues of “Data file missing”. Also we recommend that in the case of user.settings.dir.windows you use a relative file path, since mounting the USB drive on different computers might result in file paths starting with different letters, e.g. e:\, f:\, g:\…

NOTICE 2: You might want to keep a copy of your “.meta” file elsewhere, next time your FrostWire is updated it will certainly delete everything inside the folder containing binaries. All your configuration files (except .meta) and downloaded files will remain untouched (as always) after any updates.

NOTICE 3: No need to create configuration pair for operating systems you won’t use FrostWire on.

If you’re running FrostWire on an external drive we recommend that you point your “root_folder” (the place where all main default download folders go to) to be the same across different OSes, so that you can finish downloads that you may have started on a computer with say Windows (at work), on another that runs MacOSX (home), you will just have to restart the torrent, but since the data files will be on the expected location, it’ll pick up right where it left (we find this awesome)

configuration keys
(Where <osname> can be any of ‘windows’,’mac’,’posix’.)

user.settings.dir.<osname> the location where FrostWire will look for/create a settings folder which keeps track of all preferences and ongoing transfers.

user.settings.root_folder.<osname> the location of the default root downloads folder. Here FrostWire will create a “Downloads”, “From Device” and “Torrents” folders. The “Downloads” is the default save location, but you can change it in the BitTorrent settings later. “From Device” is where all files downloaded via Wi-Fi sharing will go, and “Torrents”, is where FrostWire will keep the .torrent files of transfers you start out of Bittorrent search results.

File paths can be either relative or absolute.

If you have any questions please leave a comment.
Cheers

FrostWire 5.5.6 Changelog (UPDATE 3)

Attention Technical writers, hackers and hardcore FrostWire enthusiasts, here’s the upcoming changelog for FrostWire 5.5.6 as we polish the last details and begin the testing process.

Update 3 (Apr 23 2013 – 10:38pm EST):
Download FrostWire 5.5.6 Release Candidate Installer for Windows

Update 2 (Apr 23rd 2013 – 9:32pm EST):
Download FrostWire 5.5.6 Release Candidate 2 Installer for Mac OSX

During the next hours we’ll be releasing Release Candidate Binaries for those of you who would like to help catch a few bugs in advance. This list is not final as we’re still closing the development cycle for this release.

Please fork-us and send your patch-branch via pull-request.

frostwire (5.5.6) stable; urgency=high
* New Feature: Includes search results from archive.org, which indexes millions of public domain and creative commons works from all over the internet.
* New Feature: playlist songs can be re-ordered with drag and drop.
* New Feature: all songs in a playlist can now be exported to a folder.
* Upgrade: Improved Unicode support for Chinese characters.

* Upgrade: mplayer update for unicode character file playback support.
* Upgrade: Search architecture upgrade for much faster search results.
* Upgrade: Considerably faster mp3,mp4 parsing in the library, creating playlists is now faster than ever.
* Upgrade: New more explicit Wi-Fi sharing icons.
* Upgrade: Updated radio station database.
* Upgrade: up to 20% faster listing of files in the Library.
* Upgrade: Video player upgrades for better experience.
* Bug fix: screen-saver no longer kicks in during video playback.
* Bug fix: UPnP Wi-Fi sharing discovery consumes 84% less CPU on
congested local networks. Fixing reported slowdowns and reducing
considerable power consumption for laptop users.
* Bug fix: X11 related error fix.
* Bug fix: Number of files being shared includes the number of torrents
being seeded.
* Bug fix: Library search issues related to unicode characters.
* Bug fix: Multiple null pointer exceptions and crashes fixed.
* Bug fix: Fixed rendering issue related to wrong parsing of bitrate
string data.
* Upgrade: (Developers) ant compilation scripts cleanup.
* Upgrade: (Developers) use of ‘frostwire-commons’ repository to share
common code between FrostWire for Android and Desktop projects.

— FrostWire Team <contact@frostwire.com> Mon, 22 Apr 2013 05:58:00 -0500