neofeels

neofeels is an alternative "feels" client with an intuitive curses based user interface. Just like the original feels, neofeels is a command-line blogging application. Its features are similar to livejournal or tumblr's dreamwidth.

In this guide we'll cover some of the basic functions. Check the "read documentation" menu option, inside of neofeels, for the more in depth official documentation.

You can read more about the original application in the feels wiki article.

Features

• local blogging by default
• subscriptions to favourite users
• global entry browser
• personal entry manager
• external (public) publishing
  • plain text
  • html (CSS customization)
  • gopher
• shared graffiti area
• configuration editor
• built in documentation

Usage

To start neofeels run the following command:

town neofeels

You will then be taken to the main menu.

           ___        __
          / _/__ ___ / /__
         / _/ -_) -_) (_-<
        /_/ \__/\__/_/___/
           neofeels 0.3.2

      record some feels
      manage your feels
      check out your neighbors
      browse global feels
      visit your subscriptions
      scribble some graffiti
      change your settings
      see credits
      read documentation

     ↑↓/kj move  ↵ enter  q exit

Navigating the menus

You can easily move between each menu option by using the keyboard arrow keys. Pressing the enter key will select the option that you have highlighted. You can use the vi style "j" and "k" direction keys if you prefer.

It's also possible to jump to a menu option directly via a short cut key. These keys will be highlighted in the menu options of each menu screen.

The "q" key exits the current menu. If you're at the main menu this will also exit the program. A list of additional shortcut keys will be displayed at the bottom of each screen, if available. Sometimes additional help text will appear there as well.

Create a new entry

1. Select the "record some feels" option from the main menu using the arrow keys.
2. Press the enter key.
3. Your default editor will open with an empty file.
4. Write your entry.
5. Save your file and exit the editor.
6. A confirmation message will appear telling you that your entry has been published.
7. Press the "q" key to return to the main menu.

Read the latest entries

1. Select the "browse global feels" option from the main menu using the arrow keys.
2. Press the enter key.
3. A list of the most recent entries will be displayed.
4. Select the entry that you'd like to read using the arrow keys.
5. Press the enter key.
6. The entry will be displayed using your default pager.
7. Use the page up and down keys to scroll through the entry.
8. Press the "q" key when you're done.
9. Go back to step 3 to read additional entries.

Delete an entry

1. Select the "manage your feels" option from the main menu using the arrow keys.
2. Press the enter key.
3. Select the "delete feels by day" option using the arrow keys.
4. Press the enter key.
5. Select the entry you want to delete using the arrow keys.
6. Press the enter key.
7. An "are you sure" confirmation message will appear.
8. Press the enter key again to delete the entry (or press the "q" key to cancel).

Where to go from here?

neofeels has many more options and features than what we've covered here. Be sure to check out the "read documentation" menu option as well as the links below.

Tips and tricks

Here are some advanced "pro tips" which might help improve your neofeels experience.

Word wrapping

To improve the word wrapping set the less pager environment variable to include the word wrap option. Be sure to do this before starting neofeels. Copy and paste this into your terminal or into your bashrc file:

export LESS=--wordwrap

Your default text editor

You can write entries with your favourite editor by adding one of these lines to your bashrc file:

export EDITOR=emacs
export EDITOR=vim
export EDITOR=nano

This will change your default editor for your town ssh sessions.

Temporarily change your editor

If you only want to change your editor for the current session, you can set the editor shell variable when you start neofeels:

EDITOR=emacs town neofeels

Links

• neofeels repository
• feels wiki article
• editors quifref wiki article
• ttbp repostiory

Credits

• ttbp (the original feels app) was written by ~endorphant in python
• neofeels was written by ~nbsp in go
• this wiki entry was originally written by ~innerteapot
• some text is included from the neofeels internal help (written by ~nbsp)
• tips and tricks contributions:
  • ~wesbat

last compiled: 2026-04-24 09:03:12.215281