php2Bluesky

A simple library that allows posting to Bluesky via the API.

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

With all the uncertainty surrounding the future of X (née Twitter), I decided to take a look at Bluesky which somewhat ironically has its roots in Twitter where it was started as an internal project. Bluesky is still in beta and is invite-only. I worry about Bluesky's long-term given that ultimately it too has to make money, something that Twitter has singularly failed to do. None of this, of course, affects the topic today which is posting to Bluesky via the API.

(back to top)

Built With

• PHP
• [BlueskyApi by Clark Rasmussen] (https://github.com/cjrasmussen/BlueskyApi)

(back to top)

Getting Started

Running the script is very straightforward:

1. download the code/clone the repository
2. install [composer] (https://getcomposer.org/)
3. add the BlueskyAPI

composer.phar require cjrasmussen/bluesky-api

Now you can inspect and update index.php to get some examples.

You can read more about how this all works in this blog post.

Prerequisites

Requirements are very simple, it requires the following:

1. PHP (I tested on v8.1.13)
2. Clark Rasmussen's [BlueskyApi] (https://github.com/cjrasmussen/BlueskyApi) (required v2 or above)
3. a Bluesky account and an Application Password (see this blog post for details of how to do that).

Installation

1. Clone the repo:

   git clone https://github.com/williamsdb/php2Bluesky.git

(back to top)

Usage

For more information, please refer to the this blog post

(back to top)

Known Issues

• none

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

(back to top)

Contact

Your Name - @spokenlikeageek - Contact

Project Link: [https://spokenlikeageek.com] (https://www.spokenlikeageek.com/2023/11/06/posting-to-bluesky-via-the-api-from-php-part-one/)

(back to top)

Acknowledgments

• [BlueskyApi] (https://github.com/cjrasmussen/BlueskyApi)

(back to top)