cupidterminal is a minimalist terminal emulator inspired by the principles of suckless st. It is designed to be simple, efficient, and hackable, adhering to the UNIX philosophy of doing one thing well.
- Lightweight: Minimal dependencies, only requiring
XlibandXft. - Simple Configuration: Easily customize fonts, colors, and terminal size by modifying
config.h. - Efficient Rendering: Utilizes
Xlibfor rendering text and handling input. - Keyboard Driven: Optimized for keyboard navigation with minimal mouse support.
- PTY Integration: Spawns a shell using a pseudo-terminal (PTY) for seamless command execution.
- Basic ANSI Escape Sequence Handling: Strips out basic ANSI escape sequences for clean text rendering.
- Line Buffering: Maintains a buffer of up to 100 lines with 1024 characters each for terminal output.
Ensure you have the following installed:
sudo pacman -S xorg-server libx11 libxftsudo apt-get install libx11-dev libxft-devClone the repository and compile the source code:
git clone https://github.com/cupidthecat/cupidterminal.git
cd cupidterminal
makeRun cupidterminal:
./cupidterminal- Quit: Press
qto exit the terminal emulator.
Customize cupidterminal by modifying the config.h file. Key configuration options include:
#define FONT "monospace" // Font family
#define FONT_SIZE 12 // Font size in points
#define TERMINAL_WIDTH 80 // Number of character columns
#define TERMINAL_HEIGHT 24 // Number of character rows
#define MAX_LINES 100 // Maximum number of lines in the buffer
#define MAX_CHARS 1024 // Maximum number of characters per line-
Open
config.hin your preferred text editor. -
Adjust the configuration parameters as desired.
-
Recompile the project to apply changes:
make clean && make
- Quit: Press
qto close the terminal emulator. - Backspace: Handles backspace key to delete characters.
- Input Handling: All other keypresses are sent directly to the spawned shell.
- Scrollback Buffer Support: Implement scrolling through past terminal output.
- Enhanced ANSI Escape Sequence Handling: Improve support for a wider range of ANSI codes for better text formatting.
- Dynamic Resizing: Allow the terminal window to be resized dynamically, adjusting the number of visible rows and columns accordingly.
- Clipboard Support: Enable copying and pasting text between the terminal and other applications.
- Mouse Support: Add basic mouse interaction capabilities.
- Theming: Introduce customizable color schemes and themes.
CupidTerminal is released under the MIT License. Feel free to modify and distribute it as per the license terms.
Contributions are welcome! If you have ideas for improvements or bug fixes, please submit a pull request or open an issue. When contributing:
- Keep changes minimal and focused.
- Follow the existing coding style for consistency.
- Provide clear descriptions and documentation for your contributions.
- main.c: Handles initialization, event loop, PTY management, and integrates drawing and input handling.
- draw.c / draw.h: Manages rendering text to the X11 window and maintaining the terminal buffer.
- input.h: Declares input handling functions.
- config.h: Contains configuration settings for fonts, terminal size, and other parameters.
- Makefile: Build instructions for compiling the project.
Inspired by the suckless st terminal emulator, aiming to maintain simplicity and efficiency while providing a solid foundation for further customization and enhancement.