{"id":13682725,"url":"https://github.com/Yannis4444/Orange-Share","last_synced_at":"2025-04-30T09:34:00.261Z","repository":{"id":40508650,"uuid":"382156614","full_name":"Yannis4444/Orange-Share","owner":"Yannis4444","description":"A 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 Devices","archived":false,"fork":false,"pushed_at":"2023-02-25T16:42:57.000Z","size":7171,"stargazers_count":48,"open_issues_count":9,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-02T16:45:16.482Z","etag":null,"topics":["apple","clipboard","clipboard-sync","ios","ipad","iphone","share","shortcuts-app","transfer","transfer-files"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yannis4444.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-01T21:07:00.000Z","updated_at":"2024-09-30T12:19:14.000Z","dependencies_parsed_at":"2024-08-02T13:22:37.720Z","dependency_job_id":"d9685092-5836-4fa1-82ee-92e2017ad72e","html_url":"https://github.com/Yannis4444/Orange-Share","commit_stats":{"total_commits":134,"total_committers":3,"mean_commits":"44.666666666666664","dds":"0.35820895522388063","last_synced_commit":"dd97e5b87307a2fcf7bba4f739399c3369460c5e"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yannis4444%2FOrange-Share","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yannis4444%2FOrange-Share/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yannis4444%2FOrange-Share/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yannis4444%2FOrange-Share/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yannis4444","download_url":"https://codeload.github.com/Yannis4444/Orange-Share/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223888468,"owners_count":17220082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","clipboard","clipboard-sync","ios","ipad","iphone","share","shortcuts-app","transfer","transfer-files"],"created_at":"2024-08-02T13:01:51.783Z","updated_at":"2024-11-12T02:31:37.147Z","avatar_url":"https://github.com/Yannis4444.png","language":"Python","funding_links":[],"categories":["Python","HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"Orange Share\" src=\"images/banner.png\" title=\"Orange Share\" width=\"600\"/\u003e\n\u003c/p\u003e\n\nA small python server that accepts requests from an Apple shortcut to allow sharing all sorts of media from iOS with any desktop OS.\nIt allows sending content right from the share sheet - similar to AirDrop between Apple Devices.\n\n\u003ctable\u003e\n    \u003cthead\u003e\n        \u003ctr\u003e\n            \u003ctd align=\"left\"\u003e\n                :exclamation:  Disclaimer\n            \u003c/td\u003e\n        \u003c/tr\u003e\n    \u003c/thead\u003e\n    \u003ctbody\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003e\n                    Since iOS 1.15 there are some problems with Shortcuts.\n                    Sharing links for example does not work right now and shortcuts sometimes just stop without any information.\n                    This is something I cannot control and has to be fixed by Apple.\n                    Regardless Orange Share still works for the most part, you might just need to rerun a shortcut once in a while.\n                \u003c/p\u003e\n                \u003cp\u003e\n                    I apologize for the inconvenience!\n                \u003c/p\u003e\n            \u003c/td\u003e\n        \u003c/tr\u003e\n    \u003c/tbody\u003e\n\u003c/table\u003e\n\n\n## Table of contents\n* [Quick Start](#calling-quick-start)\n* [How it works](#information_source-how-it-works)\n* [Updating](#arrow_up%EF%B8%8F-updating)\n* [Shortcuts](#link-shortcuts)\n* [Run Options](#%EF%B8%8F-run-options)\n* [Configuration](#-configuration)\n\n## :calling: Quick Start\n\nA quick start guide can be found [here](https://github.com/Yannis4444/Orange-Share/blob/master/QuickStart.md).\n\n## :information_source: How it works\nOrange Share consists of a webserver that should be able to run on any computer operating system and a few Shortcuts\nthat 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.\n\nThe shortcuts will show up in the share sheet of files, links etc. and allow you to share whatever the content is with\nthe computer it is set up with.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"share_sheet\" src=\"images/share_sheet.png\" title=\"share_sheet\" width=\"350\"/\u003e\n\u003c/p\u003e\n\nBy default, you can access the UI with settings for Orange Share on [localhost:7616](http://localhost:7616).\nHere you can also find the shortcuts and establish connections to the devices.\nThe UI is only accessible from the host.\n\nThe API which is used by the mobile devices is opened on port 7615 by default.\nIt is accessible from devices in the network and secured with Basic Auth.\nThis means that only connected devices are able to send data to the computer.\nNote that due to the http protocol, connection data will be sent over unencrypted connections.\nOrange Share never sends out any data from the computer without a confirmation on the computer,\neven if the correct credentials are set.\n\n## :arrow_up:️ Updating\n\nOnce a new version of Orange Share is available, you will be notified.\nYou can of cause ignore this if you wish to - I will not force you to update.\n\nThe Windows and GNOME Shell Extension versions can be updated right from the user interface.\nInstructions on how to do so will be shown there as well.\n\nThe pip version can be updated just like any pip package by running `pip install --upgrade orangeshare`.\n\n### New Shortcuts\n\nSome versions will come with new shortcuts.\nThese will also be marked on the update page. \nOften the old shortcuts will still work, but it is advised that you download the new ones once available.\nWhen there are newer shortcuts available, you will be notified after running shortcuts.\n\nTo get the updated shortcuts just scan the QR codes on the Shortcuts page in the user interface\nwhere you first downloaded them.\n\n## :link: Shortcuts\n\nOrange Share uses several [shortcuts](https://support.apple.com/guide/shortcuts/welcome/ios) for different parts of its functionality.\nThese shortcuts have to be installed on the device from which content shall be shared.\n\nThe shortcuts can be found in the UI of the application or below.\n\n#### Untrusted Shortcuts\n\nTo import the needed shortcuts, you might need to enable `Allow Untrusted Shortcuts` in your devices settings.\nThis option can be found in `Settings \u003e Shortcuts`.\n\nIf you have never before used Shortcuts, chances are, that `Allow Untrusted Shortcuts` is grayed out.\nIf this is the case, you have to run a shortcut first.\nTo do this, open the Shortcuts App and choose any of the available shortcuts or create one yourself.\nOnce you ran a shortcut, the option to enable untrusted shortcuts should become available.\n\n#### How to use the Shortcuts\n\nOnce the shortcuts are installed, they are shown in the Shortcuts App.\nHere you can start or edit them.\nWhen you run a shortcut that sends data to the computer here, it will send the contents of your clipboard.\n\nYou can find most shortcuts in the share sheets of the device.\nThis means that whenever you click `share` on the device you can find these shortcuts in the list.\nAt the bottom of this list you can find an option to edit the shown entries.\nHere you can add the Orange Share shortcuts to your favorites if you want them to always be at the top.\n\n### Connection Manager\n\nThis shortcut is always needed to manage the connections to the host computer running Orange Share.\nIt has to be run directly from the Shortcuts App or added to the home screen and run from there.\nIt is also possible to add this as a back tap action for easier access.\n\nThe device is able to save multiple connections while only one can be active at a time.\nIn order to do so, some files will be created on your iCloud (`/Shortcuts/orangeshare/`).\n\n[Download](https://www.icloud.com/shortcuts/c80782d8c8954b1f96de6784441fb9a6)\n\n### Open\n\nThe open shortcut will open content in its respective application on the computer.\n\nFor URLs, it will open the website in the default browser, any other files will be opened in their default applications.\nTo make this work, files are saved in a temporary folder.\n\n[Download](https://www.icloud.com/shortcuts/ebc4cd8ec7954ac68f723d79fdf30276)\n\n### Save\n\nThe save shortcut will open a save-file-dialog on the computer with which shared content can be saved anywhere on the computer.\n\n[Download](https://www.icloud.com/shortcuts/ca1d351c41e14806b40c21c995a8f4f0)\n\n### Clipboard\n\nThe clipboard shortcut will copy any text to the clipboard of the computer.\nOnce copied, it can be pasted anywhere.\n\nCopying files will be coming soon.\n\n[Download](https://www.icloud.com/shortcuts/7f10334354f9479aaf156139383f3a73)\n\n### Get Data\n\nThis shortcut can be used to get data from the computer.\nIt will open a window on the computer where either a file or the current clipboard content can be sent to the phone.\n\n[Download](https://www.icloud.com/shortcuts/f1e9e2f318f447508ab956884936c614)\n\n## 🛠️ Run Options\n\nIf you are running Orange Share from the command line you can use the following parameters.\n\nArgument | Description\n---------|------------\n-h, --help | print a help message\n--version | print the current version\n-p \\\u003cport\\\u003e, --api-port \\\u003cport\\\u003e | Port number of the api server (default: 7615)\n-u \\\u003cport\\\u003e, --ui-port \\\u003cport\\\u003e | Port number of the UI server (default: 7616)\n-o, --open-ui | Open the server controls in the browser on start\n-t, --tray-icon | Run with tray icon (only available on windows, see [Gnome Shell Extension](https://github.com/Yannis4444/Orange-Share/blob/master/QuickStart.md#gnome-shell-extension) for Linux with Gnome)\n-v, --verbose | enable Verbose output\n\n## ⚙ Configuration\n\nA configuration file can be found in the user's config directory.\nOn Linux for example this would be `~/.config/orangeshare/config.ini`.\nThe file location will also be shown in the web UI.\n\nOnce changed you will have to restart Orange Share.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYannis4444%2FOrange-Share","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FYannis4444%2FOrange-Share","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYannis4444%2FOrange-Share/lists"}