SC-IM(1)

✨ NAME ✨

okay so bestie, meet sc-im — a curses based, vim-like spreadsheet calculator. that's the whole vibe. 💅

---

🌈 SYNOPSIS 🌈

sc-im [OPTION]... [FILE]

---

💖 DESCRIPTION 💖

so sc-im is a curses based spreadsheet calculator program with vim-like key bindings. yes really. your fave text editor energy, but it's a whole spreadsheet. iconic.

SC-IM is a spreadsheet program based on SC.

okay so what even is a spreadsheet, for anyone who's been living under a rock (no shade): a spreadsheet is an interactive computer application program for organization and analysis of data in tabular form. spreadsheets were developed as computerized simulations of paper accounting worksheets. the program operates on data represented as cells of an array, organized in rows and columns. each cell of the array is a model–view–controller element that can contain either numeric or text data, or the results of formulas that automatically calculate and display a value based on the contents of other cells. like, it's giving math but make it ✨aesthetic✨.

the user of the spreadsheet can make changes in any stored value and observe the effects on calculated values. this makes the spreadsheet useful for "what-if" analysis since many cases can be rapidly investigated without tedious manual recalculation. no more crying over a calculator fr fr. modern spreadsheet software can have multiple interacting sheets, and can display data either as text and numerals, or in graphical form. SC-IM uses ncurses for visual interface and has vim-like keybindings and some functional similarities with vim text editor. the way that it just gets you 🫶

---

🎀 OPTIONS 🎀

💫 Input Control 💫

• FILE — the input file from where to read the spreadsheet. that's your source of truth, bestie.
• --sheet=SHEET — open SHEET when loading an xlsx file. can be a sheet name or a number. the default is '1'. so like, the first one, unless you say otherwise. 💅

🦋 Version 🦋

• --version — print the version number of Sc-im and exit. it also shows which features were enabled when Sc-im was compiled. a little lore drop about your own build, love that for you.

🌸 External scripts 🌸

• --nocurses — run interactive but without the ncurses interface.
• --output=FILE — save the results in FILE.
• --quit_afterload — quit after loading all the files. useful when sending scripts to SC-IM.
• --quiet — set variable 'quiet'. avoid printing info/error/debug messages. silence is golden ✨

🧚 Other configuration variables 🧚

• --autocalc — set variable 'autocalc'. recalculations occur automatically.
• --numeric — set variable 'numeric'. a digit starts a numeric value instead of a command multiplier.
• --half_page_scroll — set variable 'half_page_scroll'. <c-f>, <c-b> and other scroll mappings scroll half page instead of full page.
• --newline_action=VAL — set variable 'newline_action' VAL to j to move the cursor down after an entry. set to l to move the cursor right after an entry.
• --external_functions — set variable 'external_functions'. enable external functions.
• --xlsx_readformulas — set variable 'xlsx_readformulas'. SC-IM will try to import formulas, rather than the final values of a cell.

---

🌈 COLOR SUPPORT 🌈

most terminals are able to display 256 colors these days. but some of them enable only 16 colors by default. 😭 to enjoy sc-im's full capabilities, these terminals need to be signaled to enable 256 color mode. this is usually done by setting the TERM environment variable.

export TERM=xterm-256color

go forth and be colorful, bestie. 💜

---

👑 KEYBOARD CONTROLS 👑

• h, j, k, l, Arrow keys — move between cells.
• PgUp, pgDn — one page UP or DOWN.
• gg — jump to the first cell.
• v — starts visual selection.
• ^ — move the cell cursor to row 0 of the current column.
• 0 — move the cell cursor backward to column A of the current row.
• $ — move the cell cursor forward to the last valid column of the current row.
• b — move the cell cursor back to the previous valid cell.
• w — move the cell cursor forward to the next valid cell.
• g0 — move the cell cursor to the first visible column of the screen.
• g$ — move the cell cursor to the last visible column of the screen.
• gM — move the cell cursor to the middle column of the screen.
• gH — go to fist visible row on the screen.
• gL — go to last visible row on the screen.
• gM — go to middle row on the screen.
• mx — mark the current cell.
• 'x — jump to a marked cell.
• = — enter a numeric constant or expression into the current cell.
• < — enter a label string into the current cell. left aligned.
• > — enter a label string into the current cell. right aligned.
• { — left justify the string in the current cell.
• } — right justify the string in the current cell.
• | — center the string in the current cell.
• e — edit the value associated with the current cell. this is identical to = except that the command line starts out containing the old numeric value or expression associated with the cell. the editing in this mode is vi-like. 😌
• E — edit the string associated with the current cell. this is identical to <, ', or > except that the command line starts out containing the old string value or expression associated with the cell. the editing in this mode is vi-like.
• x — clear the current cell. deletes the numeric value, label string, and/or numeric or string expression.
• : — enter COMMAND mode.

see :help to get more help 💖

---

🌟 FEATURES 🌟

• UNDO / REDO
• 65.536 rows and 702 columns supported. (the number of rows can be expanded to 1.048.576 if wished)
• CSV / TAB delimited file import and export
• XLS / XLSX file import
• Key-mappings.
• Sort of rows
• Filter of rows
• Cell shifting
• More movements commands implemented
• Input and Output was completely rewritten
• Screen colors can be customized by user, even at runtime
• Colorize cells or give them format such as bold or underline
• Implement external functions in the language you prefer and use them in SC-IM
• Use SC-IM as a non-interactive calculator, reading its input from a external script

---

🎀 ABOUT THE NAME 🎀

the idea is that the program can be identified as another vim-like app. SC-IM stands for Spreadsheet Calculator Improvised. slay. 💅

---

💜 AUTHOR 💜

written by Andrés Martinelli and collaborators. original man page by Daniel Campoverde. kings, both of them. 👑

---

💀 BUGS 💀

for known bugs look at https://github.com/andmarti1424/sc-im/blob/master/KNOWN_ISSUES

please report bugs at https://github.com/andmarti1424/sc-im/issues

not me filing a bug report at 3am... do it though, they want to know 🫶

---

🌸 COPYRIGHT 🌸

Copyright (c) 2013-2015, Andrés Martinelli <andmarti@gmail.com>

this software is provided by Andres Martinelli ''as is'' and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. in no event shall Andres Martinelli be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

bestie this is the legal bit, so no cap: it's as is, and the warranty vibes are simply not there. 🙈

---

okay and that's the whole page, mwah. this one lives in the User Commands manual section, dated 2016-02-09, filed under SC-IM(1). go forth and spreadsheet, you absolute main character. 💖✨🎀