• A command-line interface for downloading and playing cryptic crosswords from within the terminal.
• Puzzles are sourced from the free crosswords uploaded daily to Lovatt's.
• cliptic is written in Ruby using the ncurses library

• Fix the ssl certificate bug that prevents fetching puzzles
• Fix the "out of range" bug when moving to an undefined index using g

• Add manual redraw feature to the main puzzle view. Called with ^L (useful for terminal resize)
• Add exit controls to the resize interface (q or ^C)

• VIM-like keybindings
• Puzzles scraped daily from Lovatt's. Puzzles are cached locally to prevent excessive requests
• Progress can be saved to continue puzzles at a later time
• Time taken to complete the puzzle is logged on completion of puzzle. High scores can be viewed within cliptic
• Track progress for puzzles released in the last week
• Puzzle history is tracked, making it easy to pick up recently played puzzles
• Select puzzles to play by date manually (puzzles are available for up to 9 months from release)
• Customisation of cliptic's appearance

• Ruby
• Ncurses
• Curl

• curb
• curses
• sqlite3

• cliptic is available as a Ruby Gem. To install, simply run:

gem install cliptic

• Or, to install manually:

git clone https://github.com/apexatoll/cliptic
cd cliptic
rake build install

• To run cliptic after installation, simply run the command cliptic from within the terminal
• When the program is first run it will ask the user whether they want cliptic to generate a default config file. This is located in ~/.config/cliptic/cliptic.rc
• If the screen is too small to display cliptic, please resize until the prompt disappears

• There are other commands that can be run from the command line

• The command cliptic today will play today's puzzle
• This command can be followed with a negative number to play a puzzle n days before today
• For example cliptic today -2 will play the puzzle from the day before yesterday

• The command cliptic reset will allow the user to reset progress in cliptic.
• The command can be followed with either all, states, scores or recents
• all resets all progress
• states resets all game progress
• scores resets high scores
• recents resets puzzle history

• On the main menu there are several options
  • Play today's puzzle
  • Show this week's progress
  • Select a date manually
  • Display recent puzzles
  • Show high scores
  • Exit cliptic

• By default, cliptic uses vim-like keybindings for navigation and text manipulation. There are plans to release more "accessible" keybindings in the future.
• Text manipulation is modal akin to vim. Vim-users will be familiar with insert and normal modes
• The currently focussed clue is displayed within the window at the bottom of the screen. If you are on a cell that is an intersection of two clues (ie an across and a down) you can swap between them using TAB

• There are 2 game modes that can be played. These can be changed in the cliptic config file.

1. Auto_mark = 1 (default)
   • Each clue is marked once every cell is filled
   • The clue will be highlighted green or red depending on whether the attempt is correct
2. Auto_mark = 0
   • No clues are marked automatically, similar to a paper crossword
   • Clues can be checked manually using the ^G command

• There are several ways to navigate the cells of the cliptic grid in NORMAL MODE.

• Cliptic settings can be added to the cliptic.rc file found at ~/.config/cliptic/cliptic.rc

• Affect how cliptic functions
• Set using the format

set <setting> <0/1>

• Colours are numbered 1-16.
  • 0 is default terminal color
  • 1-8 equates to your terminals 8 default colours.
  • 9-16 equate to same colours as the background and blank as the foreground
• To set colour settings use the format

hi <obj> <colour>

• Cliptic is still in development
• If you have any feature requests or find any bugs please leave a new issue
• Contributions welcome!

Dedicated to WES who passed on to me his love of crosswords