Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicoswd/put.io-adder
macOS put.io client that acts as handler for magnet: links and .torrent files, and adds them to your put.io download queue
https://github.com/nicoswd/put.io-adder
bittorrent bittorrent-client macos magnet storage streaming torrent
Last synced: about 4 hours ago
JSON representation
macOS put.io client that acts as handler for magnet: links and .torrent files, and adds them to your put.io download queue
- Host: GitHub
- URL: https://github.com/nicoswd/put.io-adder
- Owner: nicoSWD
- License: mit
- Created: 2013-07-05T00:17:17.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-06-04T18:42:59.000Z (6 months ago)
- Last Synced: 2024-11-06T07:39:20.089Z (11 days ago)
- Topics: bittorrent, bittorrent-client, macos, magnet, storage, streaming, torrent
- Language: Objective-C
- Homepage:
- Size: 5.93 MB
- Stars: 195
- Watchers: 17
- Forks: 23
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Put.io magnet: and .torrent Handler for macOS
*put.io adder* is a small open source app for macOS, that registers as new handler for `magnet:` URI schemes, so that every time you click on a magnet link, it will automatically add it to your [put.io](http://put.io/) download queue.
Follow me on Twitter: [@nicoSWD](https://twitter.com/nicoSWD)!
**Features**
- Automatically add `magnet:` links and `.torrent` files to your download queue by clicking on them
- Stream finished movies directly from the app (requires [VLC](https://www.videolan.org/vlc/index.html) to be installed in /Applications)
- View current transfers and their download status
- Double click transfers to open them on put.io
- `Notification Center` notifications on finished downloads
- etc...
**Downloads**
| Version | Chip |
|:----------:|:---------------:|
| **[put.io adder v3.0.5](https://github.com/nicoSWD/put.io-adder/releases/download/v3.0.5/put.io-adder-v3.0.5.zip)** | Apple Silicon
| **[put.io adder v3.0.4](https://github.com/nicoSWD/put.io-adder/releases/download/v3.0.4/put.io-adder-v3.0.4.zip)** | Intel
(Older releases can be found [here](https://github.com/nicoSWD/put.io-adder/releases/))
**Notes**
- The app requires you to have a [put.io](http://put.io/) account. They're ~~probably~~ not free anymore.
- The app requires Keychain Access to store put.io's OAuth Token. Denying access will prevent the app from working.
- To disable Notification Center, go to System Preferences -> Notifications -> Scroll to Put.IO Adder, and make your changes.
- There are three ways to upload `.torrent` files to your account:
- 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
Please [report issues](https://github.com/nicoSWD/put.io-adder/issues) you may encounter. Pull requests are also very welcome!
**Contributing**
[AFNetworking](https://github.com/AFNetworking/AFNetworking), [PutioKit](https://github.com/PutioKit/PutioKit), and [SSKeyChain](https://github.com/samsoffes/sskeychain) have been added as submodules. To clone the repo in its entirety, use:
`$ git clone --recursive [email protected]:nicoSWD/put.io-adder.git`
All contributions are greatly appreciated. If you want to help, send a pull request, or open a [new issue](https://github.com/nicoSWD/put.io-adder/issues/new) 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"](https://github.com/nicoSWD/put.io-adder/issues/3) option could be added.
- An option to download finished transfers to the computer through the app would be nice.
- 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*.
- ~~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](https://github.com/mikker/Putter.app/blob/master/Putter/BBAppDelegate.m).~~ (Added in v2.7)
- ~~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...