Moc

A (really) native and powerful Telegram client for macOS and iPadOS, optimized for moderating large communities and personal use.

This client is currently in development and barely usable. You can track progress by observing the project table, issues, pull requests, and a Telegram channel (russian, and soon ukrainian).

Project roadmap: Craft

If you have any questions, ask them in Discussions on GitHub, or in a Telegram group (ukrainian/russian). You are strongly encoruaged to use Discussions and the Telegram group instead of Issues for questions. Bug reports and stuff go to Issues. There is a reason why GitHub created Discussions in the first place 😄

Installation

You can install the latest release using Homebrew, GitHub, and MS AppCenter:

Homebrew

This is a preferred method of installation:

brew install --cask ggoraa/apps/moc

By the way, Moc will soon move from a custom tap to an official one, homebrew-casks!

GitHub

You can find any release in the Releases page of this
repository.

AppCenter

You can also find releases from MS AppCenter Moc page. By the way,
this is a place from which the in-app updated fetches updates 😃

OS support

Moc’s OS support model is N-1, which means “latest and previous major release”,
for example macOS 13 and 12. When there is a new OS release announced, Moc
will get ready to drop support for an oldest release. For example, if
there is macOS 13 and 12 supported, and then macOS 14 is announced, the development
team will start to remove code for supporting the macOS 12 release, and a new release
with macOS 12 support removed will be available right after a stable release of macOS
14.

Notes on iPadOS support

Support for iPads is currently very experimental and not tested much.
Why? Because I don’t have a physical device to do so, and my development Mac is too
underpowered for running Simulators with good enough performance. But still, support
for iPadOS is a thing that I ocasionally pay attention to, so yeah

If someone wants to donate me an iPad (lol who is gonna do that), use the Funding list
in this repo

Screenshots

Contributing

If you want to contribute a new feature, please make sure you have read the project roadmap. This may guide you what are current goals of the project 😄

WARNING: Ensure you have Commit Signing set up, because otherwise your commits will be rejected by GitHub (not even me!).

Building

Step 1 - Clone

Use the command below to clone the repo:

git clone https://github.com/mock-foundation/moc.git 

Step 2 - Download right version of Xcode

The development is going with Xcode 14. You can download it from
Apple Developer, or using
Xcodes (app (recommended) or
cli).

Step 3 - Obtain api_id and api_hash

They can be obtained here. Log in, open API development tools, and fill up needed info. Then click Save changes
at the bottom of the page. Leave the page open, this will be needed in the next step!

Step 4 - Set up development environment

Be sure that you have Homebrew installed, because it is used a lot here.

Now run these commands:

brew install go-task/tap/go-task
API_ID=<api_id> API_HASH=<api_hash> task setup

You can execute task setup:full if you want to also fetch SPM packages and open Xcode.

Done! You have everything set up. You can now build Moc 😁