ulu is aimed at improving the communication workflow for developers, designers, founders and PMs.
ulu brings productivity boosts:
- no stories
- inbox
- redesigned folders
- hotkeys
- CMD+K menu
- CMD+E mark chat as done
- auto-archiver
- snooze - notify about message later
- workspaces (soon)
- ... (a lot of features in development, will be announced soon)
Get updates from upstream
git remote add upstream git@github.com:Ajaxy/telegram-tt.git
git fetch upstream
git checkout master
git merge upstream/master
git commit -m "Upstream"
git push
npm run deploy
- Updates https://ulu.so
- Updates releases
- Updates the latest binaries:
- Mac ARM: https://github.com/ulu-telegram/app/releases/latest/download/ulu-arm64.dmg
- Mac x64: https://github.com/ulu-telegram/app/releases/latest/download/ulu-x64.dmg
- Linux: https://github.com/ulu-telegram/app/releases/latest/download/ulu-x86_64.AppImage
- Windows: https://github.com/ulu-telegram/app/releases/latest/download/ulu-x64.exe
git checkout deploy
git reset --hard master
git push --force
- Updates https://ulu.so
Great respect to the creators of the original project!
The original readme begins below...
This project won the first prize 🥇 at Telegram Lightweight Client Contest and now is an official Telegram client available to anyone at web.telegram.org/a.
According to the original contest rules, it has nearly zero dependencies and is fully based on its own Teact framework (which re-implements React paradigm). It also uses a custom version of GramJS as an MTProto implementation.
The project incorporates lots of technologically advanced features, modern Web APIs and techniques: WebSockets, Web Workers and WebAssembly, multi-level caching and PWA, voice recording and media streaming, cryptography and raw binary data operations, optimistic and progressive interfaces, complicated CSS/Canvas/SVG animations, reactive data streams, and so much more.
Feel free to explore, provide feedback and contribute.
mv .env.example .env
npm i
Obtain API ID and API hash on my.telegram.org and populate the .env
file.
npm run dev
Start your dev server and locate GramJS worker in console context.
All constructors and functions available in global GramJs
variable.
Run npm run gramjs:tl full
to get access to all available Telegram requests.
Example usage:
await invoke(new GramJs.help.GetAppConfig())
Electron allows building a native application that can be installed on Windows, macOS, and Linux.
npm run dev:electron
Run Electron in development mode, concurrently starts 3 processes with watch for changes: main (main Electron process), renderer (FE code) and Webpack for Electron (compiles main Electron process from TypeScript).
npm run electron:webpack
The main process code for Electron, which includes preload functionality, is written in TypeScript and is compiled using the webpack-electron.config.js
configuration to generate JavaScript code.
npm run electron:build
Prepare renderer (FE code) build, compile Electron main process code, install and build native dependencies, is used before packaging or publishing.
npm run electron:staging
Create packages for macOS, Windows and Linux in dist-electron
folders with APP_ENV
as staging
(allows to open DevTools, includes sourcemaps and does not minify built JavaScript code), can be used for manual distribution and testing packaged application.
npm run electron:production
Create packages for macOS, Windows and Linux in dist-electron
folders with APP_ENV
as production
(disabled DevTools, minified built JavaScript code), can be used for manual distribution and testing packaged application.
npm run deploy:electron
Create packages for macOS, Windows and Linux in dist-electron
folder and publish release to GitHub, which allows supporting autoupdates. See GitHub release workflow for more info.
To sign the code of your application, follow these steps:
- Install certificates from
/certs
folder tologin
folder of your Keychain. - Download and install
Developer ID - G2
certificate from the Apple PKI page. - Under the Keychain application, go to the private key associated with your developer certificate. Then do
key > Get Info > Access Control
. Down there, make sure your application (Xcode) is in the listAlways allow access by these applications
and make sureConfirm before allowing access
is turned on. - A valid and appropriate identity from your keychain will be automatically used when you publish your application.
More info in the official documentation.
Application notarization is done automatically in electron-builder module, which requires APPLE_ID
and APPLE_APP_SPECIFIC_PASSWORD
environment variables to be passed.
How to obtain app-specific password:
- Sign in to appleid.apple.com.
- In the "Sign-In and Security" section, select "App-Specific Passwords".
- Select "Generate an app-specific password" or select the Add button, then follow the steps on your screen.
In order to publish new release, you need to add GitHub access token to .env
. Generate a GitHub access token by going to https://github.com/settings/tokens/new. The access token should have the repo scope/permission. Once you have the token, assign it to an environment variable:
# .env
GH_TOKEN="{YOUR_TOKEN_HERE}"
Publish configuration in src/electron/config.yml
config file allows to set GitHub repository owner/name.
- Run
npm run electron:publish
, which will create new draft release and upload build artefacts to newly reated release. Version of created release will be the same as inpackage.json
. - Once you are done, publish the release. GitHub will tag the latest commit.
- GramJS (MIT License)
- pako (MIT License)
- cryptography (Apache License 2.0)
- emoji-data (MIT License)
- twemoji-parser (MIT License)
- rlottie (MIT License)
- opus-recorder (Various Licenses)
- qr-code-styling (MIT License)
- croppie (MIT License)
- mp4box (BSD-3-Clause license)
- music-metadata-browser (MIT License)
- lowlight (MIT License)
- idb-keyval (Apache License 2.0)
- fasttextweb
- webp-wasm
- fastblur
If you find an issue with this app, let Telegram know using the Suggestions Platform.