{"id":13584086,"url":"https://github.com/mattt/terminal-share","last_synced_at":"2025-04-06T22:31:55.676Z","repository":{"id":5150158,"uuid":"6318112","full_name":"mattt/terminal-share","owner":"mattt","description":"Command Line \u0026 Ruby Interface to Mac OS X Sharing Services","archived":true,"fork":false,"pushed_at":"2021-04-06T17:59:04.000Z","size":155,"stargazers_count":228,"open_issues_count":0,"forks_count":14,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-11-06T00:39:51.628Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"chmille4/Scribl","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattt.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}},"created_at":"2012-10-21T07:25:30.000Z","updated_at":"2024-02-22T01:55:02.000Z","dependencies_parsed_at":"2022-08-22T14:50:24.540Z","dependency_job_id":null,"html_url":"https://github.com/mattt/terminal-share","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Fterminal-share","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Fterminal-share/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Fterminal-share/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattt%2Fterminal-share/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattt","download_url":"https://codeload.github.com/mattt/terminal-share/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247563898,"owners_count":20958971,"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":[],"created_at":"2024-08-01T15:04:00.085Z","updated_at":"2025-04-06T22:31:55.418Z","avatar_url":"https://github.com/mattt.png","language":"Objective-C","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"readme":"\u003e This library is no longer being maintained.\n\n# terminal-share\n\n**macOS Sharing Services... as a Service**\n\nMac OS X 10.8 Mountain Lion introduced built-in sharing as a system-level feature\nwith programmatic access provided via the\n[`NSSharingService` APIs](https://developer.apple.com/documentation/appkit/nssharingservice).\n\n`terminal-share` extends access to these APIs\nby proxying through a simple command-line application.\n\n## Installation\n\nInstall `terminal-share` by running the following command from Terminal:\n\n```\n$ gem install terminal-share\n```\n\nThis will also install the `terminal-share` executable.\n\n```ruby\nrequire 'terminal-share'\n\nTerminalShare.share(:twitter, text: \"This was shared from the command-line, courtesy of terminal-share, by @mattt\", url: \"https://github.com/mattt/terminal-share\")\n```\n\n![Screenshot](https://raw.github.com/mattt/terminal-share/screenshots/terminal-share-screenshot.png)\n\n## Command Line\n\n```\n$ terminal-share -service NAME              \\\n                [-text text]                \\\n                [-image /path/to/image]     \\\n                [-video /path/to/video]     \\\n                [-url \"http://example.com\"]\n```\n\n### Arguments\n\n- `service`: (**Required**) A short string corresponding to the name of a particular `NSSharingService` to be used. Available values:\n  - `twitter` - `NSSharingServiceNamePostOnTwitter`\n  - `sinaweibo` - `NSSharingServiceNamePostOnSinaWeibo`\n  - `email` - `NSSharingServiceNameComposeEmail`\n  - `message` - `NSSharingServiceNameComposeMessage`\n  - `airdrop` - `NSSharingServiceNameSendViaAirDrop`\n  - `readinglist` - `NSSharingServiceNameAddToSafariReadingList`\n  - `iphoto` - `NSSharingServiceNameAddToIPhoto`\n  - `aperture` - `NSSharingServiceNameAddToAperture`\n  - `facebook` - `NSSharingServiceNamePostOnFacebook`\n  - `flickr` - `NSSharingServiceNamePostImageOnFlickr`\n  - `vimeo` - `NSSharingServiceNamePostVideoOnVimeo`\n  - `youku` - `NSSharingServiceNamePostVideoOnYouku`\n  - `tudou` - `NSSharingServiceNamePostVideoOnTudou`\n- `text`: (_optional_) Text to be shared.\n- `image`: (_optional_) File path to an image to be shared.\n- `video`: (_optional_) File path to a video to be shared.\n- `url`: (_optional_) URL to be shared.\n\n\u003e Not all services support sharing of all types of content. See the [NSSharingService Documentation](http://developer.apple.com/library/Mac/#documentation/AppKit/Reference/NSSharingService_Class/Reference/Reference.html) for additional guidelines.\n\n### Example\n\n```\n$ terminal-share -service twitter \\\n                 -text \"This was shared from the command-line,  \\\n                        courtesy of terminal-share, by @mattt\"  \\\n                 -url \"https://github.com/mattt/terminal-share\"\n```\n\n## Creator\n\nMattt ([@mattt](https://twitter.com/mattt))\n\n## Credit\n\nThanks to [Eloy Durán](https://github.com/alloy) for his work on \n[`terminal-notifier`](https://github.com/alloy/terminal-notifier), \nwhich provides a great example of how to use the Script Bridge APIs.\n\n## License\n\nterminal-share is available under the MIT license. \nSee the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattt%2Fterminal-share","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattt%2Fterminal-share","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattt%2Fterminal-share/lists"}