{"id":13729499,"url":"https://github.com/thedavecarroll/BluebirdPS","last_synced_at":"2025-05-08T01:32:47.910Z","repository":{"id":39838584,"uuid":"264241241","full_name":"thedavecarroll/BluebirdPS","owner":"thedavecarroll","description":"A Twitter Automation Client for PowerShell 7","archived":false,"fork":false,"pushed_at":"2023-06-13T04:54:09.000Z","size":1624,"stargazers_count":60,"open_issues_count":3,"forks_count":11,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-08-04T02:08:40.809Z","etag":null,"topics":["powershell","powershell-gallery","powershell-module","tweet","tweets","twitter","twitter-api","twitter-api-v1","twitter-api-v2","twitter-client","twitterdm"],"latest_commit_sha":null,"homepage":"https://docs.bluebirdps.dev","language":"PowerShell","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/thedavecarroll.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/Supporting Commands/Get-TwitterPermissions.md","governance":null,"roadmap":null,"authors":null}},"created_at":"2020-05-15T16:16:55.000Z","updated_at":"2024-03-11T01:24:27.000Z","dependencies_parsed_at":"2024-01-06T13:08:29.487Z","dependency_job_id":"f537acba-7df6-4514-a056-db143b991435","html_url":"https://github.com/thedavecarroll/BluebirdPS","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thedavecarroll%2FBluebirdPS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thedavecarroll%2FBluebirdPS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thedavecarroll%2FBluebirdPS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thedavecarroll%2FBluebirdPS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thedavecarroll","download_url":"https://codeload.github.com/thedavecarroll/BluebirdPS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224689005,"owners_count":17353307,"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":["powershell","powershell-gallery","powershell-module","tweet","tweets","twitter","twitter-api","twitter-api-v1","twitter-api-v2","twitter-client","twitterdm"],"created_at":"2024-08-03T02:01:01.269Z","updated_at":"2024-11-14T20:30:53.884Z","avatar_url":"https://github.com/thedavecarroll.png","language":"PowerShell","funding_links":[],"categories":["Libraries"],"sub_categories":["PowerShell"],"readme":"# BluebirdPS: A Twitter Automation Client for PowerShell 7\n\n\u003cimg align=\"left\" src=\"docs/images/bluebirdps-logo.jpg\" alt=\"BluebirdPS\" height=\"115\" width=\"115\"/\u003e This is the project repo for BluebirdPS, a Twitter automation client for PowerShell 7.\n\n![PowerShell Gallery Downloads](https://img.shields.io/powershellgallery/dt/bluebirdps?label=PowerShell%20Gallery%20Downloads\u0026logo=PowerShell\u0026style=for-the-badge)\n![PowerShell Gallery Version (including pre-releases)](https://img.shields.io/powershellgallery/v/bluebirdps?color=blue\u0026include_prereleases\u0026label=PowerShell%20Gallery\u0026logo=PowerShell\u0026style=for-the-badge)\n\n[![Standard](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fstandard)](https://developer.twitter.com/en/docs/twitter-api)\n[![v2](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fv2)](https://developer.twitter.com/en/docs/twitter-api)\n\n## No Longer Active\n\nDue to the recent changes with the Twitter API primarily regarding the new tiers, I will no longer continue developing this project.\nIt should be considered stale and no new versions will be released.\nThe latest version, v0.8.4, seeks to correct an issue in the Free Tier with `Publish-Tweet`.\n\nThis module will allow you to tweet, retweet, send direct messages, manage lists, and more, if you pay for the Basic or Pro Tiers.\nOtherwise, you should be able to tweet and delete tweets if using the Free Tier.\n\nSee [Twitter API Documentation](https://developer.twitter.com/en/docs/twitter-api) for details.\n\n## Community Module\n\nThis module was developed for the community and accepted feedback from the community to make it what it had become.\n\n## Pre-requisites\n\nIn order to use this module, you will need to have PowerShell 7 installed and a Twitter Developer account and a Twitter Project/App created and request to API v2 Early Access.\n\n## PowerShell 7\n\nIn order to support cross-platform scenarios, PowerShell 7 was chosen as the version for this new module.\nFocusing on a single version will also allow us to forego handling the API calls differently between Windows PowerShell and PowerShell 7.\n\nPlease see [Installing various versions of PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-7) for instructions on installing PowerShell 7.\nYou can install it on virtually any modern operating system - Windows, MacOS, or Linux.\n\n## Developer Account, Project, App, and Access Tokens\n\nIn order to use BluebirdPS, or any other Twitter API client or library, you will need to go through several steps to gain access to the API.\n\n### Applying for a Developer Account\n\nYou must apply for a developer account at https://developer.twitter.com/en/apply-for-access.\nThis process could take a couple weeks.\n\n### Activate Developer Portal\n\nNext, activate your developer portal at https://developer.twitter.com/content/developer-twitter/en/portal/opt-in.\n\n### Create a Project and Register a Developer App\n\nYou must have a project with a developer app created in the portal.\n\n### Apply for Access for the Twitter API v2: Early Access\n\nVisit the [Twitter API Getting Started](https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api) page for details and additional links.\n\n### Generate Account Tokens\n\nFrom the portal, you will need to generate the consumer key, otherwise called the API Key and Secret.\nThe API Key is linked to your application.\n\nYou will also need to generate an Access Token and Secret.\nThe Access Token is linked to your Twitter user account.\n\nThe application must be given access permissions of Read, Write, and Direct Message for full usage.\nAt minimum, the application needs Read access for any Get- commands.\nSet-, Send-, and Publish-Tweet require Write access, while *-TwitterDM requires Direct Message access.\n\nYou can also generate a Bearer Token through the portal, or simply use the Set-TwitterAuthentication command.\nIf your credentials are validated, the bearer token will be requested and set in the authentication file, as well.\n\n```powershell\nSet-TwitterAuthentication\n```\n\n```console\nAPI Key: *************************\nAPI Secret: **************************************************\nAccess Token: **************************************************\nAccess Token Secret: *********************************************\n```\n\n## How to Install\n\n### From the PowerShell Gallery\n\nStart PowerShell 7 and run the following command:\n\n```powershell\nInstall-Module -Name BluebirdPS -Scope CurrentUser\n```\n\nFor more information, please visit the [BluebirdPS page] on the PowerShell Gallery.\n\n[BluebirdPS page]: https://bit.ly/BluebirdPS\n\n### From the GitHub Release Page\n\n1. Click [here] to go to the latest releases, then download the BluebirdPS.zip file attached to the release.\n2. Right-click the downloaded zip, select Properties, then unblock the file.\n  *This is to prevent having to unblock each file individually after unzipping.*\n3. Unzip the archive.\n4. *(Optional)* Place the module somewhere in your PSModulePath.\n    * You can view the paths listed by running the environment variable `$env:PSModulePath`\n\n[here]: https://github.com/thedavecarroll/BluebirdPS/tags\n\n### Building from the GitHub Repo\n\n1. Clone repo to a folder of your choice.\n2. Change into the local repo folder.\n3. Install and Import Module `psake`, `BuildHelpers`, `PowerShellBuild`\n4. Install [dotnet (6.0)](https://dotnet.microsoft.com/en-us/download/dotnet)\n5. Run the `build.ps1` script.\n6. `Import-Module -Path .\\BuildOutput\\BluebirdPS\\\u003cmodule version\u003e\\BluebirdPS.psd1`\n\n## Examples\n\n```PowerShell\nSearch-Tweet -SearchString \"(from:thedavecarroll)\"\n\nGet-Tweet -Id 1398279333823791104\n\nPublish-Tweet -TweetText \"A new release of #BluebirdPS will soon be released. BluebirdPS is #PowerShell 7 Twitter automation client. Check it out! https://bit.ly/BluebirdPS\"\n\nGet-TwitterList -Id 1397040831777984512 | Add-TwitterListMember -UserName thedavecarroll,BluebirdPS\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthedavecarroll%2FBluebirdPS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthedavecarroll%2FBluebirdPS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthedavecarroll%2FBluebirdPS/lists"}