https://github.com/neved4/center
🛠️ Centers text read from stdin!
https://github.com/neved4/center
Last synced: about 1 month ago
JSON representation
🛠️ Centers text read from stdin!
- Host: GitHub
- URL: https://github.com/neved4/center
- Owner: Neved4
- License: gpl-3.0
- Created: 2025-03-24T15:46:09.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-24T16:36:36.000Z (about 2 months ago)
- Last Synced: 2025-03-24T17:28:54.621Z (about 2 months ago)
- Language: C
- Size: 22.5 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[][C17]
[][POSIX.1-2024]
[](https://github.com/Neved4/homebrew-tap/blob/main/Formula/center.rb)
# center - Centers text from stdin! 🛠️
[`center`] reads input from `stdin`, calculates the width of each line
(considering multibyte characters), and center-aligns the text within the
terminal window. Fully supports UTF-8.
###### Originally by [Lizzy Fleckenstein][LizzyFleckenstein03/center] 🤍
### Highlights
- **Terminal size detection**: Adjusts text to fit the terminal width.
- **Multibyte support**: Properly handles UTF-8 Unicode characters.
- **Text centering**: Prints each line centered within the terminal.
- **Error handling**: Graceful handling of system call failures.
## Getting Started
### Prerequisites
If you are building [`center`], you'll need:
- A C compiler that supports [C99] or later.
### Installing
If you have [Homebrew] installed, just run:
```sh
brew install Neved4/homebrew-tap/center
```
### Implementation
[`center`] operates as follows:
1. Opens `/dev/tty` to get the terminal width.
2. Reads input line-by-line.
3. Calculates character width (supporting multibyte characters).
4. Prints each line centered in the terminal.
### Examples
Below is an example of how the [`center`] command works in practice:
```console
$ echo 'Hello World!' | center
Hello World!
```
## Compatibility
Runs on _**Linux**_, _**macOS**_ and _**\*BSD**_ systems on [`x86_64`] and
[`arm64`], and compiles with [`zig`], [`clang`], [`gcc`], [`tcc`] and any other
compiler that supports [C99] or later.
## Standards
[`center`] is compatible with [POSIX.1-2024][][^1] as well as the [C23][][^2] standard.
## See Also
For further reference and related tools, check out the following:
- [LizzyFleckenstein03/center]
## License
[`center`] is licensed under the terms of the [GPLv3 License].
See the [LICENSE](LICENSE) file for details.
[`arm64`]: https://en.wikipedia.org/wiki/AArch64
[`center`]: https://github.com/Neved4/center
[`clang`]: https://clang.llvm.org/
[`gcc`]: https://gcc.gnu.org/
[`tcc`]: https://bellard.org/tcc/
[`x86_64`]: https://en.wikipedia.org/wiki/X86-64
[`zig`]: https://ziglang.org/
[C99]: https://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf
[C17]: https://www.open-std.org/jtc1/sc22/wg14/www/docs/n2310.pdf
[C23]: https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf
[GPLv3 License]: https://www.gnu.org/licenses/gpl-3.0.en.html
[Homebrew]: https://brew.sh/
[LizzyFleckenstein03/center]: https://github.com/LizzyFleckenstein03/center/blob/master/center.c
[POSIX.1-2024]: https://pubs.opengroup.org/onlinepubs/9799919799/
[^1]: _IEEE Std 1003.1-2024: Standard for Information Technology
— Portable Operating System Interface (POSIX®)_, \
ISO/IEC DIS 9945. URL: https://pubs.opengroup.org/onlinepubs/9799919799/
[^2]: _ISO/IEC 9899: Standard for Information Technology
— Programming languages — C_, ISO/IEC 9899:2023. \
URL: https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3096.pdf