Awesome
Editor
<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.svg" alt="Get it on F-Droid" height="80">
Android simple generic text editor. The app is available from F-Droid and here
Issues
There have been a number of issues raised on this app where users have obviously not read this README, looked at the documentation, or looked at old closed issues. Please read the README, read the docs, and look at the old issues before raising another one, you can search the issues from the box at the top.
Large files
Editor loads the whole of file to be edited into memory. It will not load large files (larger than ~500Kb) which would cause performance issues or cause the app to crash. Please do not raise issues about the Too large dialog shown when attempting to load a large file.
This is a fairly simple generic text editor which may be used standalone or to show or edit any sort of text file from another app. If you select a text file in a file manager or similar app you will be offered the option of using this editor along with whatever other apps you have installed that can show or edit a text file. Files will initially be opened read only, long touch on the display or touch the edit item in the toolbar to enable editing.
There are five toolbar items which may appear:
- Edit – Edit the current read only file
- View – View the current file read only
- Save – Save the current file if modified
- New – Start a new empty file
- Open – Open a text file using a chooser
And on the menu:
- Open recent – Pop up a list of recent files
- Clear list – Clear list of recent files
- Search – Interactive search of text using a regular expression
- Find all – Find all recent files containing search text
- Save as – Save the current file with a new name
- Go to – Scroll to selected position in file
- Print – Print current file
- View markdown – View markdown in browser or html viewer
- Charset – Change the current character set, shows current set
- Options – Select options
- View files – Open files read only for viewing
- Open last – Open last opened file on startup
- Auto save – Save the current file on app pause
- Word wrap – Limit text width to screen width and word wrap
- Suggestions – Text input and spelling suggestions
- Highlight syntax – Highlight programming language syntax
- Theme – Choose theme
- Light
- Dark
- System
- White
- Black
- Retro
- Text size – Choose text size
- Small
- Medium
- Large
- Typeface – Choose typeface
- About – Show version, copyright and licence
Edit
Edit the current read only text.
View
View the current file read only.
Save
Save the current file if modified.
New
Start a new empty file. Use the Save as item to save the new file.
Open
Choose a file to open from the chooser dialog that pops up. The parent folder will be the first in the list. See File Chooser. The file will initially be read-only. Touch the Edit toolbar item to enable editing.
Open recent
Choose a file from the list that pops up. As above the file will initially be read only. The last entry, Clear list, will clear the list.
Save as
Use the dialog and the Save button or the Storage button to use the android file manager to save the file.
Search
Enter search text in the field that pops up in the toolbar. The first matching item will be highlighted. Use the search button in the keyboard for find next. The exact regular expression syntax used is in the android documentation for Pattern.
Find all
You may find all recent files that contain the current search text. This menu item will only appear while the search widget is active. A dialog will pop up with a list of matching files. Touch an entry to open that file. You may repeat this or refine the search text to find the desired file.
Go to
Select position in the current file on the horizontal seek bar in the dialog which will pop up.
Print the current file. If you would like the output highlighted, you will need to scroll slowly through the whole file to give the app a chance to highlight it. Caution – Attempting to print a large file on an older device with limited resources may cause the app to stop responding.
View markdown
You will be prompted to choose a viewer for an html file containing the encoded markdown from the current open file. If the text contains no markdown the result will be the same text.
Shortcuts
You may create a New file or an Open file shortcut in the launcher. The New file widget will create an shortcut to open a new file in Editor. The Open file widget will pop up a dialog showing the file chooser. You may choose a file or use the Storage button. You may cancel and fill in the name and path fields, or edit the name or path fields after choosing a file. Use the Create button to create the shortcut. Note – content URIs returned by the android file picker will not be resolved.
Regular expressions
Explaining regular
expressions used in
the text search is beyond the scope of this README. There is at least
one
book
devoted to the subject. Use (?i)
for case insensitive search.
Character set
The current character set is displayed under the current file name. The character set is optionally detected when a new file is read. It may be changed by selecting the Charset item in the menu, which shows the current character set. See Character set.
Typeface
The Typeface menu item shows a choice of common typefaces. These are aliases for the fonts commonly provided on android devices. Some of them resolve to the same font, depending on the device.
Highlight syntax
If the current open file is a C, C++, Objective C, Go, Java, Javascript, Python, Shell script, Swift, CSS, HTML, Org or Markdown file, the keywords, classes comments, strings, etc will be highlighted. See Syntax Highlighting.
Mode line
If a line of text is found within the first or last two or three lines of the file which matches the mode line pattern, the mode of the editor will be changed after the file is loaded. See Mode line.
# ed: [[no]vw] [[no]ww] [[no]sg] [[no]hs] [cs:u] [th:l|d|s|w|b|r] [ts:l|m|s] [tf:m|p|s]
Word count
The file word count and character count are shown in the toolbar. Due to the algorithm used, the result may differ from that produced by other utilities.
Extended selection
If the file being edited is not a plain text file, selections created by double tapping or long touching on the text will be extended to enclosing delimiters (brackets, quotes) on the same text line.
Text size
Text size may be changed from the menu or by pinch or expand gestures on the text or by doubletap and swipe. The response to gestures on large files may be slow or delayed.
Unsaved file
If you touch the new, back or open button, and the current file has been modified, you will be prompted whether you want to save it, else the editor will just exit or open a file chooser. The current file may be saved on app pause using the menu option. The scroll position and name will be remembered for the last 10 files opened.
Changed file
If a file has changed in storage while it was open in the editor, if you attempt to save it, or the app is resumed, you will be prompted whether to overwrite or reload the file.
Default file
If there is no open file any text entered will by default be saved in
Documents/Editor.txt
. This file will be loaded on start if it
exists. Use the Save as
menu item to save it elsewhere.
Shared file
Text files opened or shared by another app may be viewed and
edited. Some apps may share files or text using a content
URI that
is not resolvable to a path to a file in storage. In that case the
editor will read the file into a new file. The Save item will save
the file in the original location if possible.
Note – Apps that share files will usually only give another app read permission. Use the Save as menu item to save the file elsewhere.
Keyboard shortcuts
When using an external keyboard, some keyboard shortcuts are implemented:
- Ctrl+E – Edit mode
- Ctrl+Shift+E – View mode
- Ctrl+F – Search
- Ctrl+Shift+F – Close search
- Ctrl+Alt+F – Find next
- Ctrl+G – Go to
- Ctrl+M – Show menu
- Ctrl+N – New file
- Ctrl+O – Open file
- Ctrl+S – Save file
- Ctrl+Shift+S – Save as
- Ctrl++ – Increase text size
- Ctrl+- – Decrease text size
- F3 – Find next
- F10 – Show menu Many other shortcuts – Ctrl+A, Ctrl+C, Ctrl+V, Ctrl+X, Ctrl+Z are already build in to android.
SD cards
Android allows removable SD cards to be used like a USB stick or as part of the device storage. Files opened using the file chooser on a removable SD card may not save successfully using the save button. Use the Save as menu item and the Storage button to save it using the android file manager. Alternatively use the Storage button on the file chooser dialog to open the file using the android file manager. See File Chooser.