opendrop
An open Apple AirDrop implementation written in Python
Science Score: 54.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
2 of 4 committers (50.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (16.0%) to scientific vocabulary
Keywords
Repository
An open Apple AirDrop implementation written in Python
Basic Info
- Host: GitHub
- Owner: seemoo-lab
- License: gpl-3.0
- Language: Python
- Default Branch: master
- Homepage: https://owlink.org
- Size: 108 KB
Statistics
- Stars: 9,147
- Watchers: 81
- Forks: 284
- Open Issues: 53
- Releases: 6
Topics
Metadata Files
README.md
OpenDrop: an Open Source AirDrop Implementation
OpenDrop is a command-line tool that allows sharing files between devices directly over Wi-Fi. Its unique feature is that it is protocol-compatible with Apple AirDrop which allows to share files with Apple devices running iOS and macOS. ~~Currently (and probably also for the foreseeable future), OpenDrop only supports sending to Apple devices that are discoverable by everybody as the default contacts only mode requires Apple-signed certificates.~~ We support contacts-only devices by using extracted AirDrop credentials (keys and certificates) from macOS via our keychain extractor.
Disclaimer
OpenDrop is experimental software and is the result of reverse engineering efforts by the Open Wireless Link project. Therefore, it does not support all features of AirDrop or might be incompatible with future AirDrop versions. OpenDrop is not affiliated with or endorsed by Apple Inc. Use this code at your own risk.
Requirements
To achieve compatibility with Apple AirDrop, OpenDrop requires the target platform to support a specific Wi-Fi link layer. In addition, it requires Python >=3.6 as well as several libraries.
Apple Wireless Direct Link. As AirDrop exclusively runs over Apple Wireless Direct Link (AWDL), OpenDrop is only supported on macOS or on Linux systems running an open re-implementation of AWDL such as OWL.
Libraries.
OpenDrop relies on a current version of libarchive.
macOS ships with a rather old version, so you will need to install a newer version, for example, via Homebrew:
bash
brew install libarchive
OpenDrop automatically sets DYLD_LIBRARY_PATH to look for the Homebrew version. You may need to update the variable yourself if you install the libraries differently.
Linux distributions should ship with more up-to-date versions, so this won't be necessary.
Installation
Installation of the Python package release is straightforward using pip3:
pip3 install opendrop
You can also install the current development version by first cloning this repository, and then installing it via pip3:
git clone https://github.com/seemoo-lab/opendrop.git
pip3 install ./opendrop
Usage
We briefly explain how to send and receive files using opendrop.
To see all command line options, run opendrop -h.
Sending a File or a Link
Sending a file is typically a two-step procedure. You first discover devices in proximity using the find command.
Stop the process once you have found the receiver.
$ opendrop find
Looking for receivers. Press Ctrl+C to stop ...
Found index 0 ID eccb2f2dcfe7 name John’s iPhone
Found index 1 ID e63138ac6ba8 name Jane’s MacBook Pro
You can then send a file (or link, see below) using
$ opendrop send -r 0 -f /path/to/some/file
Asking receiver to accept ...
Receiver accepted
Uploading file ...
Uploading has been successful
Instead of the index, you can also use ID or name.
OpenDrop will try to interpret the input in the order (1) index, (2) ID, and (3) name and fail if no match was found.
Sending a web link. Since v0.13, OpenDrop supports sending web links, i.e., URLs, so that receiving Apple devices will immediately open their browser upon accepting. (Note that OpenDrop receivers still only support receiving regular files.)
$ opendrop send -r 0 -f https://owlink.org --url
Receiving Files
Receiving is much easier. Simply use the receive command. OpenDrop will accept all incoming files automatically and put received files in the current directory.
$ opendrop receive
Current Limitations/TODOs
OpenDrop is the result of a research project and, thus, has several limitations (non-exhaustive list below). I do not have the capacity to work on them myself but am happy to provide assistance if somebody else want to take them on.
Triggering macOS/iOS receivers via Bluetooth Low Energy. Apple devices start their AWDL interface and AirDrop server only after receiving a custom advertisement via Bluetooth LE (see USENIX paper for details). This means, that Apple AirDrop receivers may not be discovered even if they are discoverable by everyone.
Sender/Receiver authentication and connection state. Currently, there is no peer authentication as in Apple's AirDrop, in particular, (1) OpenDrop does not verify that the TLS certificate is signed by Apple's root and (2) that the Apple ID validation record is correct (see USENIX paper for details). In addition, OpenDrop automatically accepts any file that it receives due to a missing connection state.
Sending multiple files. Apple AirDrop supports sending multiple files at once, OpenDrop does not (would require adding more files to the archive, modify HTTP /Ask request, etc.).
Our Papers
- Alexander Heinrich, Matthias Hollick, Thomas Schneider, Milan Stute, and Christian Weinert. PrivateDrop: Practical Privacy-Preserving Authentication for Apple AirDrop. 30th USENIX Security Symposium (USENIX Security ’21), August 14–16, 2019, virtual Event. Paper Website Code
- Milan Stute, Sashank Narain, Alex Mariotto, Alexander Heinrich, David Kreitschmann, Guevara Noubir, and Matthias Hollick. A Billion Open Interfaces for Eve and Mallory: MitM, DoS, and Tracking Attacks on iOS and macOS Through Apple Wireless Direct Link. 28th USENIX Security Symposium (USENIX Security ’19), August 14–16, 2019, Santa Clara, CA, USA. Paper
Authors
License
OpenDrop is licensed under the GNU General Public License v3.0.
Owner
- Name: Secure Mobile Networking Lab
- Login: seemoo-lab
- Kind: organization
- Location: Darmstadt, Germany
- Website: https://seemoo.de
- Repositories: 92
- Profile: https://github.com/seemoo-lab
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!
cff-version: 1.2.0
title: 'OpenDrop: an Open Source AirDrop Implementation'
message: 'If you use this software, please cite it as below.'
type: software
authors:
- given-names: Alexander
family-names: Heinrich
affiliation: 'SEEMOO, TU Darmstadt'
orcid: 'https://orcid.org/0000-0002-1150-1922'
- given-names: Milan
family-names: Stute
affiliation: 'SEEMOO, TU Darmstadt'
orcid: 'https://orcid.org/0000-0003-4921-8476'
- given-names: Matthias
family-names: Hollick
affiliation: 'SEEMOO, TU Darmstadt'
orcid: 'https://orcid.org/0000-0002-9163-5989'
repository-code: 'https://github.com/seemoo-lab/opendrop'
abstract: >-
OpenDrop is a command-line tool that allows sharing files
between devices directly over Wi-Fi. Its unique feature is
that it is protocol-compatible with Apple AirDrop which
allows to share files with Apple devices running iOS and
macOS.
license: GPL-3.0
commit: cbc7ca46a75bb2da4af9d406732ddf2192578388
version: '0.13'
date-released: '2021-04-29'
GitHub Events
Total
- Issues event: 5
- Watch event: 461
- Issue comment event: 14
- Fork event: 18
Last Year
- Issues event: 5
- Watch event: 461
- Issue comment event: 14
- Fork event: 18
Committers
Last synced: 10 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Milan Stute | m****e@s****e | 60 |
| Makito | s****o@h****m | 1 |
| Alexander Heinrich | a****h@s****e | 1 |
| Michael E. Palmer | m****p@m****t | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 103
- Total pull requests: 15
- Average time to close issues: about 2 months
- Average time to close pull requests: about 2 months
- Total issue authors: 94
- Total pull request authors: 12
- Average comments per issue: 2.75
- Average comments per pull request: 1.33
- Merged pull requests: 7
- Bot issues: 0
- Bot pull requests: 1
Past Year
- Issues: 5
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 5
- Pull request authors: 0
- Average comments per issue: 0.4
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- Titaniumtown (3)
- midozalouk (3)
- yurivict (2)
- acheong08 (2)
- warpdesign (2)
- ElevonsJKeloids (2)
- JanBittendorf (2)
- jlukanc1 (1)
- andreakiro (1)
- ino2020 (1)
- IronBit-0 (1)
- hgjhgo (1)
- milke (1)
- ryuujo1573 (1)
- SamuraiDestroy (1)
Pull Request Authors
- schmittner (4)
- vergenzt (2)
- vinaysb (1)
- lgtm-com[bot] (1)
- benonymity (1)
- mepster (1)
- scott-weeden (1)
- sumimakito (1)
- Cascian08 (1)
- bentettmar (1)
- marvic2409 (1)
- brywil (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 2
-
Total downloads:
- pypi 703 last-month
-
Total dependent packages: 0
(may contain duplicates) -
Total dependent repositories: 5
(may contain duplicates) - Total versions: 16
- Total maintainers: 1
proxy.golang.org: github.com/seemoo-lab/opendrop
- Documentation: https://pkg.go.dev/github.com/seemoo-lab/opendrop#section-documentation
- License: gpl-3.0
-
Latest release: v0.13.0
published almost 5 years ago
Rankings
pypi.org: opendrop
An open Apple AirDrop implementation
- Homepage: https://owlink.org
- Documentation: https://opendrop.readthedocs.io/
- License: GNU General Public License v3 (GPLv3)
-
Latest release: 0.13.0
published almost 5 years ago
Rankings
Maintainers (1)
Dependencies
- black *
- flake8 *
- flake8-bugbear *
- isort *
- pylint *
- pytest *
- Pillow *
- fleep *
- ifaddr *
- libarchive-c *
- requests *
- requests_toolbelt *
- zeroconf >=0.24.2
- actions/checkout master composite
- actions/create-release v1 composite
- actions/checkout v1 composite
- actions/setup-python v1 composite
- actions/checkout v1 composite
- actions/setup-python v1 composite
- actions/checkout v1 composite
- actions/setup-python v1 composite