Awesome
Share to ChatGPT Shortcut
Share to ChatGPT is an Apple Shortcut that allows users to share highlighted text to ChatGPT while also including personalized prompts, the response message will automatically be copied to the user's clipboard.
Installation
The shortcut is released on RoutineHub, you can install it from there:
https://routinehub.co/shortcut/14636/
Or install from the direct link on iCloud:
https://www.icloud.com/shortcuts/25262952f34544e99b9e6678056c1168
While installing, the shortcut will ask you to enter your OpenAI API key. If you don't have one, you can get it from the OpenAI dashboard.
Usage
After installation, the shortcut will be available in the Shortcuts app. Follow the steps below to initialize the shortcut:
- Open the shortcut
- Type something like "hello" for testing purpose, and choose a built-in prompt like "chat".
- Click "Allow" for every confirmation dialog.
Step 1 | Step 2 | Step 3 |
---|---|---|
<img width="200" src="images/init/step-1.PNG" /> | <img width="200" src="images/init/step-2.PNG" /> | <img width="200" src="images/init/step-3.JPEG" /> |
To create an easily accessible shortcut for daily use, follow these steps:
- Open the share sheet by highlighting some text and tapping the share button.
- Scroll to the bottom and select "Edit Actions".
- Scroll to the bottom again and choose "Share to ChatGPT".
- This will place the shortcut at the top of the share sheet for easy access.
Step 1 | Step 2 | Step 3 | Step 4 |
---|---|---|---|
<img width="200" src="images/share-sheet/step-1.jpg" /> | <img width="200" src="images/share-sheet/step-2.jpg" /> | <img width="200" src="images/share-sheet/step-3.jpg" /> | <img width="200" src="images/share-sheet/step-4.jpg" /> |
Finally, let's see how to use the shortcut in action. Here's an example to use the shortcut to revise a sentence:
- Highlight the text and click "Share" in the tooltip
- Click "Share to ChatGPT" in the share sheet
- Choose "revise" in the dialog
- Preview the result, which has already been copied to the clipboard
Step 1 | Step 2 | Step 3 | Step 4 |
---|---|---|---|
<img width="200" src="images/revise/step-1.jpg" /> | <img width="200" src="images/revise/step-2.jpg" /> | <img width="200" src="images/revise/step-3.jpg" /> | <img width="200" src="images/revise/step-4.PNG" /> |
Accessibility
Keyboard Shortcut
On MacOS, you can set a global keyboard shortcut to run this shortcut. To do this, open the "Keyboard" preference pane, select "Shortcuts", select "Services" on the left, and then select "Share to ChatGPT" in the "Shortcuts" section. You can then set a keyboard shortcut for it.
iPhone Back Tap
Run this shortcut by tapping the back of your iPhone: 1. On your iPhone, go to Settings > Accessibility > Touch. 2. Scroll down, then select Back Tap. 3. Select either Double Tap or Triple Tap. 4. Scroll down to the Shortcuts area, then choose Rephrase With GPT.
Tap Back Tap to apply the setting.
Prompts
The shortcut has the following built-in prompts.
Prompt | Content |
---|---|
revise | Revise the following sentences to make them more clear concise and coherent |
summarize | Summarize the following text |
translate | Translate the following text to English |
chat | - |
The message sent to ChatGPT is generated by concatenating the prompt and the shared text. For example if you choose the "revise" prompt and share the text "nice to see you", the message will be:
Revise the following sentences to make them more clear concise and coherent:
nice to see you
Please note that the chat prompt is a special prompt that is empty. It will directly pass the shared text without modification.
You can also add your own prompts by editing the shortcut.
Configuration
The configuration is stored in the shortcut, you can change them by clicking the "…" sign of this shortcut in the Shortcuts app, and then click the ⓘ symbol at the bottom of the screen, and then click "Customize Shortcut" to open the configuration dialog.
Here's the meaning of each configuration item:
API-key
: Your OpenAI API keyAPI-base-url
: The base URL of the API endpoint. By default it'shttps://api.openai.com/v1/
. You can change it to use a different API endpoint if you understand this setting.model
: The model to use for ChatGPT API. By default it'sgpt-3.5-turbo
. For a complete list see models of/v1/chat/completions
in Model endpoint compatibility.history-file
: The file name to store messages history. The history file path would beiCloud Drive/Shortcuts/Share-to-ChatGPT/$date/$history-file
. If omitted, messages will not be recorded.
Changelog
- 1.0.0 - Initial release.
- 1.0.1 - Fix a bug that the shortcut cannot determine empty user input properly.
- 1.0.2 - Enhance error output.
- 1.1.0
- Store configuration in the shortcut setup by utilizing the "Import Questions" feature. No config file anymore.
- Add message history support. When history file name is set, the shortcut will record messages in the history file.
- 1.2.0 - Add
model
configuration item.
Credits
- This project was inspired by ChatGPT-Siri and it provided me with valuable assistance while working with Shortcuts.app's editor.
- Rephrase With GPT is a similar shortcut focuses on rephrasing text. It's a great shortcut and I highly recommend it.