✨ Add Messages MMSShowSubject command (#332) (#351)

Co-authored-by: Owen Hayes <11745012+owen-hayes@users.noreply.github.com>

docs/.vitepress/config.js

@@ -436,6 +436,15 @@ export default defineConfig({
           { text: 'Dock Icon type', link: '/activity-monitor/icontype.md' },
         ],
       },
+      {
+        text: 'Messages',
+        items: [
+          {
+            text: 'Show Subject Field',
+            link: '/messages/show-subject-field.md',
+          },
+        ],
+      },
       {
         text: 'Miscellaneous',
         items: [

docs/index.md

@@ -181,6 +181,10 @@ defaults rename ${domain} ${old_key} ${new_key}
 - [Update Frequency](./activity-monitor/updateperiod.md)
 - [Dock Icon type](./activity-monitor/icontype.md)
 
+### Messages
+
+- [Show Subject Field](./messages/show-subject-field.md)
+
 ### Miscellaneous
 
 - [Help Menu position](./misc/devmode.md)

docs/messages/index.md

@@ -0,0 +1,20 @@
+---
+title: Messages
+description: Messages serves as a comprehensive messaging platform in macOS, allowing users to send and receive iMessages, photos, videos, and audio messages seamlessly across Apple devices. When connected with an iPhone, users can send and receive SMS and MMS messages directly from their Mac.
+head:
+  - - meta
+    - property: 'og:title'
+      content: macOS defaults > Messages
+  - - meta
+    - property: 'og:description'
+      content: Messages serves as a comprehensive messaging platform in macOS, allowing users to send and receive iMessages, photos, videos, and audio messages seamlessly across Apple devices. When connected with an iPhone, users can send and receive SMS and MMS messages directly from their Mac.
+---
+
+# Messages
+
+Messages serves as a comprehensive messaging platform in macOS, allowing users to send and receive iMessages, photos, videos, and audio messages seamlessly across Apple devices.
+When connected with an iPhone, users can send and receive SMS and MMS messages directly from their Mac.
+
+## Keys
+
+- [Show Subject Field](./show-subject-field.md)

docs/messages/show-subject-field.md

@@ -0,0 +1,61 @@
+---
+title: Show Subject Field | Messages
+description: Show the subject field which appears above the iMessage/Text Message field in Messages. Text entered in the subject field will be sent in bold (unless there is no text in the iMessage/Text Message field; in this case, the text in the subject field will be sent without the bold effect).
+head:
+  - - meta
+    - property: 'og:title'
+      content: macOS defaults > Message > Show Subject Field
+  - - meta
+    - property: 'og:description'
+      content: Show the subject field which appears above the iMessage/Text Message field in Messages. Text entered in the subject field will be sent in bold (unless there is no text in the iMessage/Text Message field; in this case, the text in the subject field will be sent without the bold effect).
+---
+
+# Show Subject Field
+
+Show the subject field which appears above the iMessage/Text Message field in Messages. Text entered in the subject field will be sent in bold (unless there is no text in the iMessage/Text Message field; in this case, the text in the subject field will be sent without the bold effect).
+
+<!-- break lists -->
+
+- **Tested on macOS**:
+  - Sonoma
+- **Parameter type**: bool
+
+## Set to `true`
+
+Show the subject field in Messages
+
+```bash
+defaults write com.apple.MobileSMS "MMSShowSubject" -bool "true" && killall Messages
+```
+
+<img
+  src="./images/show-subject-field/true.png"
+  alt="Messages app with subject field showing"
+  height="550"
+/>
+
+## Set to `false` (default value)
+
+Hide the subject field in Messages
+
+```bash
+defaults write com.apple.MobileSMS "MMSShowSubject" -bool "false" && killall Messages
+```
+
+<img
+  src="./images/show-subject-field/false.png"
+  alt="Messages app with subject field hidden"
+  height="550"
+/>
+
+## Read current value
+
+```bash
+defaults read com.apple.MobileSMS "MMSShowSubject"
+```
+
+## Reset to default value
+
+```bash
+defaults delete com.apple.MobileSMS "MMSShowSubject" && killall Messages
+```