search

bajrangCoder / acode-plugin-acodex

AcodeX is a plugin for the Acode app that adds terminal support, making coding more productive and efficient.
https://acode.app/plugin/bajrangcoder.acodex
MIT License
124 stars 18 forks source link
acode nodejs plugin terminal termux xtermjs

readme

AcodeX - Terminal Emulator

[!Warning] This plugin requires the acodex-server NodeJS package to be installed and running on Termux.

AcodeX is a powerful and AI integrated terminal plugin with 70k++ downloads for Acode that enhances your coding productivity by adding in-app Termux terminal integration. With AcodeX, you can execute terminal commands directly from within the Acode app, eliminating the need to switch between apps for coding and terminal access.

[!Note] When starting a new terminal, be sure to adjust the terminal panel according to your screen. You can drag it to your desired position, and it will automatically adjust the columns and rows according to your screen size.

Buy Me A Coffee

Buy Me a Coffee at ko-fi.com

If you can then support this project financially with any of the payment method ☺️ - Click Me 💗

Update v3.1.6

 - Image rendering support - Option to hide maximise terminal button - Added Key binding for maximising terminal - `Ctrl-Shift-T`


For previous change logs/updates, visit: Change Log

💥 Features

Prerequisites

To use AcodeX, you need to have the Termux app installed on your Android device. However, you don't need to switch between apps to use the terminal, as AcodeX offers a convenient way to access the terminal directly within the Acode app with the help of Termux.

Installation

  1. Install the plugin in the Acode App from Acode > Settings > Plugins > AcodeX.

  2. Install the server in Termux using the following command:

curl -sL https://raw.githubusercontent.com/bajrangCoder/acode-plugin-acodex/main/installServer.sh | bash

or

pkg update && pkg upgrade -y
pkg install python nodejs -y
npm i -g acodex-server

Basically just install python & nodejs and then just install acodex-server npm package globally

But if you are installing it on termux then make sure to run this command first to bypass the termux specific issue:

cd $HOME && mkdir -p .gyp && echo "{'variables': {'android_ndk_path': ''}}" > .gyp/include.gypi

[!Note] You can uninstall python after successful installation of acodex-server

How to Use

Tutorial link: https://youtu.be/sXlIhrbpjyw

Additional Terminal Keybindings

AcodeX provides some additional Keybindings for easy usability of terminal features.

[!Note] These keybindings will only work if you will use these inside terminal only. except the * marked one

Following are the supported Keybindings :

How to Use AI

To leverage the power of artificial intelligence within AcodeX Terminal Plugin, follow these steps:

  1. Obtain API Key: Before using the AI capabilities, you need to acquire an API key for the respective model you wish to utilize. Visit the website of your chosen model and obtain the API key. Once obtained, navigate to the AcodeX settings and input the API key. Additionally, you can select your preferred model from the list of currently supported models, which include:

  2. Accessing AI in the Terminal:

    • To access the AI functionality within the terminal, simply type #. This action will prompt a popup window to appear.
    • Within the popup window, you can input your prompt or query.
    • Upon entering your prompt, click the button provided to prompt the AI to generate a command based on your input.
    • The generated command will be written into the terminal. From there, you have the option to execute the command as is or modify it according to your requirements.

[!Warning] Avoid prompts that may lead the AI to provide descriptive or explanatory responses instead of actionable commands.

[!Note] Use AI wisely, as there may be token limits associated with your API key. Be mindful of your usage to avoid exceeding token limits and potential interruptions in service.

We value your feedback! Please provide any suggestions or feedback to help us improve the AI integration and suggest additional AI models for future enhancements.

Stay tuned for more AI integrations and improvements coming soon 😊!

API Docs

The acodex plugin provides a set of api to interact with the AcodeX terminal.

execute(cmd: string, withEnter?: boolean = true) => void

Executes a command in the AcodeX terminal.

isMinimized() => boolean

Returns a boolean indicating whether the AcodeX terminal is currently minimized or not.

isTerminalOpened() => boolean

Returns a boolean indicating whether the AcodeX terminal is currently opened or not.

maximiseTerminal() => void

Maximizes the AcodeX terminal if it is opened and minimized.

openTerminal(termContainerHeight: number = 270, port: number = this.settings.port) => Promise<SessionAPI>

Opens the AcodeX terminal.

createSession() => Promise<SessionAPI>

Creates a new terminal session.

changeSession(sessionName: string) => Promise<SessionAPI>

Changes the active terminal session.

closeTerminal() => void

Closes the AcodeX terminal if it is opened.

convertAcodeUriToTermReadable(path: string) => string

Converts an Acode URI to a format readable by the terminal.

addTheme(themeName: string, colorSchema: object) => void

Adds a new theme to the AcodeX terminal.

applyTheme(themeName: string) => void

Applies a theme to the AcodeX terminal.

SessionAPI Object

The SessionAPI object provides methods for interacting with the terminal session.

onmessage(callback: (data: string | Uint8Array) => void) => void

Registers a callback function to be called when a message is received form server.

write(cmd: string, withEnter: boolean = true) => void

Writes/Executes a command to the terminal.

Example Usage

const acodex = acode.require("acodex");

acodex.execute("ls"); // execute the ls command in terminal
const isMinimized = acodex.isMinimized();
const isOpened = acodex.isTerminalOpened();
acodex.maximiseTerminal();

const session = await acodex.openTerminal();
session.onmessage(data => console.log(data));
session.write("ls");

const sessionSocket = await acodex.createSession();
sessionSocket.onmessage(data => console.log(data));
sessionSocket.write("ls");

const changeSessionSocket = await acodex.changeSession("AcodeX2");
changeSessionSocket.onmessage(data => console.log(data));
changeSessionSocket.write("ls");

acodex.closeTerminal();
const termReadablePath = acodex.convertAcodeUriToTermReadable("file://storage/emulated/0/myTheme/acode/file/path");
acodex.addTheme("myTheme", { background: "#fff", text: "#000" }); // you can find more colors in themes.js
acodex.applyTheme("myTheme");

Custom Fonts

Custom fonts are provided to load any other external fonts

To load a custom font:

  1. Download the font files(Note: Download nerd font file in case if you are loading for termux theme).
  2. Create a css file anywhere in the internal storage.
  3. Write CSS code to load font files using relative URLs in the CSS, for example:
@font-face {
    font-family: "MesloLGS NF Regular";
    src: url("./MesloLGS NF Regular.ttf") format("truetype");
    font-weight: normal;
    font-style: normal;
}
  1. Open AcodeX Settings page and find the option "Custom Font StyleSheet".
  2. Select your CSS file created in step 3.
  3. Enter the font name in the Font Family option.
  4. Restart the terminal.

Acknowledgments

AcodeX is made possible by the use of:

Authors

🚀 Feature Requests

We welcome your suggestions for enhancing AcodeX. If you have an idea for a new feature or improvement, please consider opening a feature request on our GitHub Issues page. Be sure to provide detailed information about the feature you'd like to see, along with any use cases or scenarios that could benefit from it.

🐞 Bug Reports

If you encounter any issues or unexpected behavior while using AcodeX, please help us by reporting the problem. To report a bug, visit our GitHub Issues page and create a new issue. Please include the following information in your bug report:

🚀 Contribute to AcodeX

Your contributions are highly appreciated and welcome! You can contribute to the AcodeX Plugin in various ways:

👨‍💻 Contribute Code

  1. Fork the Repository: Start by forking the AcodeX Plugin repository

  2. Create an Issue: If you plan to add new features or fix a bug, it's a good practice to create an issue first. Describe the problem or feature you want to work on. This allows for discussion and collaboration with the maintainers.

  3. Make Changes: After forking the repo, create a new branch, and start working on your changes.

  4. Open a Pull Request: Once your changes are ready, open a pull request (PR) on the original repository. Reference the issue you created if relevant.

  5. Code Review: Your PR will be reviewed by the maintainers, and feedback may be provided. Be prepared to make adjustments if needed.

  6. Merge: Once your PR is approved, it will be merged into the main branch. Congratulations, your contribution is now part of AcodeX Plugin!

Steps to setup AcodeX locally

  1. Fork it and Clone the repo

    git clone https://github.com/bajrangCoder/acode-plugin-acodex.git

  2. navigate to acodex directory and install the dependency

    pnpm install

  3. For building the plugin zip

    pnpm build

[!Warning] You will need acodex-server NodeJS package to be installed and running on Termux to test the plugin.

💰 Contribute Financially

You can also support the development of AcodeX Plugin by making a financial contribution. Donations help in maintenance and further development.

Buy Me A Coffee

Buy Me a Coffee at ko-fi.com

⭐ Star on GitHub

If you find AcodeX Plugin useful, consider giving it a star on GitHub. It's a simple way to show your appreciation and help others discover the project. and You can review AcodeX on https://acode.app

Your contributions, whether through code, financial support, or a simple star, make AcodeX Plugin better for the entire community. Thank you for your support!

License

MIT

❤️❤️ Thanks for using AcodeX ❤️❤️