Skip to content

OmegaAOL/cerulean

Repository files navigation

Cerulean for Bluesky

image

Screenshot of release 1.0 running on Reunion7

This is the repository for Cerulean, an open-source Bluesky client. It recently exited beta and is now quite usable. It is written in C# and .NET Framework 2.0, and uses WinForms (fully native). It runs on Windows 98 and up.

cerulean-git-NEW

OS compatibility

Windows: Official minimum is Windows 98, can run on Windows 95 with MattKC's backport. Windows 2000 or higher is recommended as it provides a much better experience.

Mac OS and Linux: Supported with WINE. No reported problems.

What Cerulean can do (so far)

  • Accounts: Logging in (2FA supported), resetting password, saving credentials with DPAPI encryption, creation
  • Tabs: tabbed feed browsing lets you have multiple different feeds in tabs
  • Posts: viewing, creating, liking, reposting/unreposting, quote posts, deleting posts, viewing embeds, viewing hashtags, sharing posts, permalinking to posts, opening posts/threads in browser, collapsing posts
  • Feeds: timeline, discover, custom feed selection, tabbed feed browsing
  • Threads: viewing in Reddit-style UI with custom depth markers
  • Profiles: searching for profiles and viewing profile information, following and unfollowing
  • Notifications: view notifications, including follows, likes and replies
  • Chat: view a list of your current chats
  • PDSes: Cerulean is fully compatible with custom PDSes and can also create an account in the PDS if implemented server-side. Both invite-only and public PDSes supported.
  • Themes: There is experimental theme support starting from Release 1.3 beta 2. It is not fully complete and may look broken.

What needs to be fixed

  • Uploading images to posts
  • Reporting users and posts, blocking users

What needs to be added

  • Multiple account support
  • Searching for posts
  • Viewing all posts of a particular user
  • Starter packs
  • Actual functioning chat
  • Lists

Release nomenclature

Current

Releases follow a decimalized numbering system. The syntax is [major version].[minor version] (for example 1.2). Beta releases are not decimalized. For example, the second beta of release 1.3 would be release 1.3 beta 2, not release 1.3.1 or release 1.3b0.1. The first release was Release 1.0.

Beta here represents a pre-release and is not related to the historical Beta stage.

Historical

  • Alpha 0.0.1 - 0.0.4 followed iterative decimalization. The first Alpha release was Alpha 0.0.1.
  • Alpha 0.10 - 0.20 dropped the second decimal and added release jumping (e.g. jump 5-10 places if important release).
  • Beta releases added the second decimal back. The first Beta release was Beta 0.1.0. (this was a counting reset from Alpha)
  • Crimson releases stopped release jumping, and incremented by 1 major version for every 10 minor. The first Crimson release was Crimson 0.2.9c and picked up from Beta.

Building Cerulean

The project is open-source, but licensed under the GPLv3 - any forks should credit both me and the Cerulean project.

This project is built using Microsoft Visual Studio 2010 and .NET Framework 2.0. You can use VS2026/2022/etc, but I recommend you use VS2010 due to how incredibly lightweight it is and the great improvements in performance you will notice. If you are encountering issues:

  • Enable .NET Framework 2.0 in Windows Features, and check the compile bar & Project Settings to see if you're building for x86 (not Any CPU or x64).
  • If you've tried that and it still doesn't work, file an issue.

Please stick to the existing code style when submitting pull requests. This includes not removing commented-out code.

Credits

Any libraries linked are .NET 2.0 versions. Some may be severely out of date. Find newer versions for new projects.

Thank you!

If you made it this far, thank you. I do not have a donation option at the moment, but I will put one up eventually as the app becomes usable. Please consider donating if you can.

About

.NET 2.0 Bluesky client that runs on Windows 98 to 11.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published