/put.io-adder

OS X put.io client that adds a new handler for magnet: links and .torrent files, and adds them to your put.io download queue (putio, bittorrent).

Primary LanguageObjective-CMIT LicenseMIT

Put.io magnet: and .torrent Handler for OS X

alt tag

put.io adder is a small, open source app for OS X, that registers as new handler for magnet URI schemes, so that every time you click on a manget link, it will automatically add it to your put.io download queue.

Versions 1.4 and above now automatically upload .torrent files you choose to open with the app, and add them to the download queue as well. There are three ways to do that:

  • Drag the .torrent file onto the app icon
  • Make put.io adder your default handler for .torrent files
  • Or right click the torrent and pick "Open with" > put.io adder

Versions 2.0 and above now let you see your current transfers. Double clicking a transfer will open it in the browser, so you can download it. Support for multiple languages has been added. Feel free to add more!

Follow me on Twitter: @nicoSWD!

NOTES

  • The app requires you to have a put.io account. They're probably not free anymore.
  • The app requires KeyChain Access to store put.io's OAuth Token. Denying access might prevent the app from working.
  • To disable NotificationCenter, go to System Preferences -> Notifications -> Scroll to Put.IO Adder, and make your changes.

IMPORTANT: I added AFNetworking, PutioKit, and SSKeyChain as submodules. So if you want to clone the entire repo, please use:

$ git clone --recursive git@github.com:nicoSWD/put.io-adder.git

Please report issues you may encounter. Pull requests are also very welcome!

DOWNLOADS

CONTRIBUTE

All contributions are greatly appreciated. If you want to help, send a pull request, or open a new issue with a feature request. Some ideas for improvement are:

  • Check if put.io adder is the default handler for magnet links and torrent files on startup. ~/Library/Preferences/com.apple.LaunchServices.plist needs to be parsed and/or modified for that. If it's not, an alert asking to change that should be fired.
  • A "Default folder preference" option could be added.
  • An option to download finished transfers to the computer through the app would be nice.
  • A setting to automatically cancel finished transfers that are currently seeding, in order to speed up the download process of other transfers.
  • Design improvements.
  • A way to stream finished files through the app.
  • Authentication could be improved by adding a new custom URI scheme. When authenticating, the browser should open and go to put.io's authentication page, and a callback to something like putio://callback would open the app and pass over the OAuth token. Just like mikker's Putter app does. (Added in v2.7)
  • A way to browse through existing files and folders on put.io.
  • More languages.
  • Settings could be moved to a new preference pane in System Preferences.
  • Besides Notification Center, a badge could be added to the app icon, indicating the number of finished downloads. Or the download progress could be shown there.
  • etc...

SCREENSHOTS

alt tag alt tag alt tag alt tag alt tag

CHANGELOG New in this version:

  • v2.7
    • Authentication callback uses a custom scheme, making the app independent of my own server now.
    • A screenshot (if available) will be displayed in NSUserNotification.
    • Cleanup
  • v2.6.1
    • Fixed torrent upload issue
  • v2.6
    • Clicking on a notification will open the file on put.io
    • Download progress shows in the status bar
  • v2.5
    • Ability to cancel transfers
    • Further NotificationCenter bug fixes
    • Fixed spelling mistake (thanks to fbparis for reporting this)
    • Fixed German translation
  • v2.4
    • Fixed NC bug
  • v2.3
    • Added NotificationCenter support
  • v2.2
    • Automatically updates transfer list after adding a new torrent/magnet
    • Added proper support for "in queue" statuses
  • v2.1
    • Fixes a torrent upload issue
  • v2.0 (Big update)
    • View your transfers (double click opens file in browser)
    • Support for multiple languages (feel free to add more)
    • Added preferences pane (⌘ + ,)
    • Automatically checks for updates
  • v1.6 (by orta)
    • Support for auto closing after uploading (option in menu bar)
    • Minor design changes
    • Auth window improvements
  • v1.5
    • Added UTTypeIconFile
    • Version # in UI
    • Changed text a bit
  • v1.4
    • Added support for .torrent files
    • Changed UI
    • Added PutIO Kit
  • v1.3
    • Displays account info
    • Added link to GitHub repo in menu bar
  • v1.2
    • Now displays the "display name" instead of the magnet URL
    • Moved code a bit around
    • Better error control
  • v1.1
    • Now compiles with Xcode 4
    • Compatible with OS X < 10.8
    • New Design
  • v1.0
    • Initial release

MIT/X11 LICENSE

Copyright (C) 2013 Nicolas Oelgart

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.