Package: orangeshare
Orange ShareA small python server that accepts requests from an Apple shortcut to allow sharing all sorts of media from iOS with any desktop OS.
It allows sending content right from the share sheet - similar to AirDrop between Apple DevicesHow it worksOrange Share consists of a webserver that should be able to run on any computer operating system and a few Shortcuts
that allow the user to open, save and copy content from an iPhone or iPad to a computer as well as request data from the computer.The shortcuts will show up in the share sheet of files, links etc. and allow you to share whatever the content is with
the computer it is set up with.By default, you can access the UI with settings for Orange Share onlocalhost:7616.
Here you can also find the shortcuts and establish connections to the devices.
The UI is only accessible from the host.The API which is used by the mobile devices is opened on port 7615 by default.
It is accessible from devices in the network and secured with Basic Auth.
This means that only connected devices are able to send data to the computer.
Note that due to the http protocol, connection data will be sent over unencrypted connections.
Orange Share never sends out any data from the computer without a confirmation on the computer,
even if the correct credentials are set.Quick StartInstallationChoose one of the following methods of installation depending on the system you want to install on.WindowsGo to thereleases,
download the newest Orange Share executable (orangeshare-x.x.x.exe)
and run the installer.This Version of Orange Share will show an icon in the system tray (lower right corner; may be hidden behind the up arrow).
The Tray Icon offers a right click menu to start, stop and exit Orange Share.It also allows you to add Orange Share to Windows startup when installing.
If you enable this option Orange Share will start as inactive and can be activated from the tray.GNOME Shell ExtensionA GNOME Shell Extension is availablehere.When first enabling Orange Share by clicking the icon in the top bar, you will be prompted to install the python package.
I was not allowed to host the python part on the GNOME Shell Extension page which is why installing and updating will be taken care of using pip.Once everything is installed, you can enable and disable Orange Share by clicking on an icon in the top bar.
Right-click will open a short menu with some options and double-clicking the icon will open the settings in your browser.Using PIPOrange Share can be installed by runningpip install orangeshare.After that, it can be run using the commandpython -m orangeshareor justorangeshareon Linux.Downloading the ShortcutsTo use Orange Share you will need a few Shortcuts.
These can be downloaded right from the user interface by scanning the QR codes with the camera app on your iPhone/iPad.There are different Shortcuts with different functions.
Here I will only go over the basics you need to know to get started.
You can find a more in depth description in the user interface and [below](https://github.com/Yannis4444/Orange-Share#shortcuts.If you run into problems with "untrusted shortcuts" take a look atthis.
This is a security mechanism from Apple to make sure users do not just run any shortcut.Connecting a Device to the ComputerAll the communication between the shortcuts and the computer use Basic Auth to avoid unauthorised requests.
Therefore, you need to create a new connection under Connected Devices in the settings.There you can set the name of your computer which is only relevant for display purposes on the devices and the IP address of your computer.
The IP will be saved in combination with your WiFi name.
This means that you can set different IPs for different Networks.
If you are unsure which IP is the right one just go through them until one works.To add a connection click ADD and then enter a name for the connection.
Click ADD again and scan the resulting QR code using the Connection Manager Shortcut (Scann QR Code).
This will establish and test the connection.You can manage connected devices from this shortcut as well.
To connect to a computer you can also simply scan the QR code again.If you wish to synchronise your connection between your devices you can set to do so using iCloud here too.Sharing DataOnce everything is set up, you can choose any content you wish to share on your iPhone/iPad (like a photo) and click share.
There you should find the different Orange Share options.If you wish to have Orange Share always appear on top you can useEdit Actions...at the bottom of this list.Requesting Data from the ComputerThere is also theGet DataShortcut which allows you to request data from the computer.You have now completed the basic steps to set up Orange Share and should be able to share content between you devices.
If you encounter any problems please let me know by creating an issue.UpdatingOnce a new version of Orange Share is available, you will be notified.
You can of cause ignore this if you wish to - I will not force you to update.The Windows and GNOME Shell Extension versions can be updated right from the user interface.
Instructions on how to do so will be shown there as well.The pip version can be updated just like any pip package by callingpip install --upgrade orangeshare.ShortcutsOrange Share uses severalshortcutsfor different parts of its functionality.
These shortcuts have to be installed on the device from which content shall be shared.The shortcuts can be found in the UI of the application or below.Untrusted ShortcutsTo import the needed shortcuts, you might need to enableAllow Untrusted Shortcutsin your devices settings.
This option can be found inSettings > Shortcuts.If you have never before used Shortcuts, chances are, thatAllow Untrusted Shortcutsis grayed out.
If this is the case, you have to run a shortcut first.
To do this, open the Shortcuts App and choose any of the available shortcuts or create one yourself.
Once you ran a shortcut, the option to enable untrusted shortcuts should become available.How to use the ShortcutsOnce the shortcuts are installed, they are shown in the Shortcuts App.
Here you can start or edit them.
When you run a shortcut that sends data to the computer here, it will send the contents of your clipboard.You can find most shortcuts in the share sheets of the device.
This means that whenever you clickshareon the device you can find these shortcuts in the list.
At the bottom of this list you can find an option to edit the shown entries.
Here you can add the Orange Share shortcuts to your favorites if you want them to always be at the top.Connection ManagerThis shortcut is always needed to manage the connections to the host computer running Orange Share.
It has to be run directly from the Shortcuts App or added to the home screen and run from there.
It is also possible to add this as a back tap action for easier access.The device is able to save multiple connections while only one can be active at a time.
In order to do so, some files will be created on your iCloud (/Shortcuts/orangeshare/).DownloadOpenThe open shortcut will open content in its respective application on the computer.For URLs, it will open the website in the default browser, any other files will be opened in their default applications.
To make this work, files are saved in a temporary folder.DownloadSaveThe save shortcut will open a save-file-dialog on the computer with which shared content can be saved anywhere on the computer.DownloadClipboardThe clipboard shortcut will copy any text to the clipboard of the computer.
Once copied, it can be pasted anywhere.Copying files will be coming soon.DownloadGet DataThis shortcut can be used to get data from the computer.
It will open a window on the computer where either a file or the current clipboard content can be sent to the phone.DownloadAdvanced OptionsRun OptionsArgumentDescription-h, --helpprint a help message--versionprint the current version-p <port>, --api-port <port>Port number of the api server (default: 7615)-u <port>, --ui-port <port>Port number of the UI server (default: 7616)-o, --open-uiOpen the server controls in the browser on start-t, --tray-iconRun with tray icon (only available on windows, seeGnome Shell Extensionfor Linux with Gnome)-v, --verboseenable Verbose outputLinux AutostartTo run Orange Share at system startup you can copy theorange-share.desktopto the~/.config/autostartdirectory.Autostart for windows and GNOME can be handled by the installer and the extension.ConfigurationA configuration file can be found in the user's config directory.
On Linux for example this would be~/.config/orangeshare/config.ini.
The file location will also be shown in the web UI.Once changed you will have to restart Orange Share.