Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/okibcn/nano-for-windows
Windows version of the GNU Nano editor
https://github.com/okibcn/nano-for-windows
command-line nano ssh terminal text-editor windows
Last synced: 3 months ago
JSON representation
Windows version of the GNU Nano editor
- Host: GitHub
- URL: https://github.com/okibcn/nano-for-windows
- Owner: okibcn
- License: gpl-3.0
- Created: 2023-01-26T03:31:26.000Z (almost 2 years ago)
- Default Branch: releases
- Last Pushed: 2024-07-31T00:53:18.000Z (3 months ago)
- Last Synced: 2024-07-31T03:47:59.960Z (3 months ago)
- Topics: command-line, nano, ssh, terminal, text-editor, windows
- Homepage: https://github.com/okibcn/nano-for-windows
- Size: 41.6 MB
- Stars: 134
- Watchers: 4
- Forks: 3
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - okibcn/nano-for-windows - Windows version of the GNU Nano editor (Others)
README
# NANO FOR WINDOWS
[](https://github.com/okibcn/nano-for-windows/actions/workflows/Xbuild4Windows.yml) [](https://github.com/okibcn/nano-for-windows/actions/workflows/SyncNano.yml)
[](https://github.com/okibcn/nano-for-windows/releases/latest) [](https://github.com/okibcn/nano-for-windows/blob/releases/README.md#installation)
This is a 64-bit/32-bit and Windows on ARM port of the legendary **[GNU nano text editor](https://www.nano-editor.org/)**, a small and compact CLI editor that packs a world of functionality in a small footprint (less than 300KB). It can be run in a Windows Terminal, Powershell window, Command Prompt window, SSH session, or similar environment.
GNU nano is constantly being upgraded, but the original project is focused on providing support and functionality for Linux. This project is meant to bring the latest updates to both 64-bit and 32-bit Windows users.
# Features ported to Windows
Pretty much everything is supported except for Linux-specific functions, including:
- Interface customization: colors, key shortcuts, line numbers, infobar, scroll bar, etc...
- Syntax coloring for 47 different types of documents. It can be upgraded thanks to community support, for instance [here](https://github.com/scopatz/nanorc) or [here](https://github.com/mitchell486/nanorc) you can find additional syntax files for many other document types.
- Full support for UTF-8 encoded files.
- Supplemental Unicode character support, including all the languages and emojis 😜in the CLI interface.
- Multi-document editor.
- Integrated file browser.
- Mouse support for scroll and cursor location.
- Normal and regular expression (regex) search and replace.
- Auto-indent, syntax highlight and fast line comment for many programming languages.
- Line wrap, search, cut, copy & paste, and all the basic functions of any full-fledged editor.
- Data input through stdin support, from a pipe or the keyboard.
- Transparent backgrounds in Windows Terminal, and other supported environments.
- Beta native support for Windows on ARM (WoA)
# Installation
The easiest way to install nano is via **[Scoop](https://scoop.sh/)**.
1. To install Scoop, open a PowerShell terminal (version 5.1 or later) and run:
```pwsh
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # Optional: Needed to run a remote script the first time
irm get.scoop.sh | iex
```
2. Add nano for Windows directly from its bucket:
```pwsh
scoop bucket add .oki https://github.com/okibcn/Bucket # Optional: the changes are propagated faster this way
scoop install nano
```
To remove the app, type:
```pwsh
scoop uninstall nano
```
To update the app, type:
```pwsh
scoop update nano
```
# Installation via direct download
Visit the [releases](https://github.com/okibcn/nano-for-windows/releases) page, and download the latest release file ending in `.zip` for your architecture (Windows 32, Windows 64, or Windows on Arm). Then unzip the file to a directory in your `%PATH%`.
# Usage
This repo handles only the conversion to the Windows OS. The original GNU nano **[documentation](https://www.nano-editor.org/docs.php)** covers all the usage instructions. For a quick reference, you can just press F1 within nano to open the integrated help.
The interface customization file is located in the user profile and has good descriptions of each setting. To edit it, just open a powershell terminal, and type:
```pwsh
nano ~/.nanorc
```
# Notes
- When using Windows Terminal and the screen is resized within nano, after returning to the shell there could be some corruption due to the new size. To fix the issue without losing the terminal history just resize the terminal window to zero lines and return to the desired size.
- Feel free to open any issue you find, or use the [Discussions](https://github.com/okibcn/nano-for-windows/discussions) section for any other issue, suggestion, question, etc...