CALMIRA NEXTGEN  version 1.1
=============================

Slovak version of this file: SKREADME.TXT
Copyright (c) 2026 Peter Protus. All rights reserved.
Inspired by Calmira II by Li-Hsin Huang.

Calmira NextGen is a modern replacement shell for Microsoft Windows 3.1.
It takes the place of Program Manager and gives Windows 3.1 a desktop with
icons, a taskbar, a Start menu, folder windows, a two-pane file manager and
a set of small programs - all in a few hundred kilobytes, written for 16-bit
Windows and tuned for 386/486 machines.

Requirements: Windows 3.1 or 3.11 (Enhanced mode), a 386 or better, VGA or
better. About 2 MB of disk space and a few hundred KB of memory for the shell.


WHAT'S NEW IN 1.1
-----------------
 - Three looks of the shell: Modern (glass), Flat and Classic (Windows 95), plus
   your own skins (SKINS\*.INI, see "Skins" below). On displays of 256 colours
   or fewer Flat is the default. Choose them in Display Properties > Background.
 - New Start button picture (icons\start16.ico for 16 colours, icons\start256.ico
   for 256 colours and more) in every look except Classic.
 - The left side of the Start menu works like the Program Manager: the groups
   (.GRP) are listed directly under the pinned and frequent programs, with
   "New group...". StartGroups=0 in START.INI [Settings] brings back the single
   "Program Manager" row.
 - Windows Setup (WINDIR\SETUP.EXE) is an icon of the Control Panel window.
 - Classic 16-colour icons for Computer, Documents and Recycle Bin on 256 colours.
 - Fixed: Settings crashed on a 256-colour display. NEXTGEN.LOG now also records
   the steps of the Settings dialog.


WHAT IS INCLUDED
----------------
 NEXTGEN.EXE   The shell: desktop, taskbar, Start menu, folder windows.
 CALMIRA.DLL   Settings, display properties, tips and other dialogs.
 NEXTGENX.DLL  Folder window extras (preview panel, file operations).
 NGZIP.DLL     ZIP packing and unpacking.
 MSFDLG.DLL    File dialog used by the Calmira programs and, through a hook,
               by other programs (Notepad etc.): Esc closes it, a New Folder
               button creates a folder and lets you rename it in place.
 MSHOOK.DLL    Title-bar buttons for all windows (minimize, maximize, close).
 CALCMD.EXE    Calmira Commander - two-pane file manager.
 CALPAD.EXE    Calmira Pad - text editor (Notepad replacement).
 CALWRT.EXE    Calmira Writer - rich text (RTF) editor.
 CALVIEW.EXE   Calmira View - image viewer (BMP, JPEG, PNG, GIF).
 CALPLAY.EXE   Calmira Player - MP3 / WAV player with playlist.
 CALCLIP.EXE   Calmira Clipboard - clipboard viewer and history.
 CALTASK.EXE   Task manager in the style of Windows NT.
 CALSHELL.EXE  Keeper for the shell (only installed when Calmira is set as
               the Windows shell; restarts Calmira after an update or crash).
 SETUP.EXE     Installer, updater and uninstaller (SETUP.EXE /U).
 LANG\          Languages (SK, DE, FR, EN .LNG files). To add a language, copy
               EN.LNG there under another name and translate it.


FEATURES
--------
Desktop and taskbar
 * Desktop that is a real folder: files, folders and shortcuts, free icon
   placement, drag and drop, Computer, Documents and Recycle Bin.
 * Taskbar with task buttons, Quick Launch, system tray for all programs,
   clock with date, volume control, window preview and title on hover.
 * Three looks: modern glass, flat (one colour, the default on 16 / 256
   colour displays) or classic Windows 95; light and dark theme;
   skins and Start orbs; wallpaper (centre, tile, stretch), patterns,
   background colour and a screen saver.
 * Title-bar buttons on every window, window menu with program icon.

Start menu
 * Pinned items, most used programs, program groups (.GRP), right-click
   to pin or remove, Settings, Run, Shut Down.
 * Modern two-column menu or the classic Windows 95 menu (keyboard and
   mouse hover supported).

Folder windows (built-in Explorer)
 * Long file names, drives, disks and folders in ordinary windows.
 * Back / Forward (Alt+Left / Alt+Right), Cut / Copy / Paste, Properties.
 * Preview panel: text, pictures (incl. progressive JPEG), icons, MP3 tags.
 * Recycle Bin with restore, disk properties, formatting, CD eject.
 * ZIP archives open as folders; add to ZIP / extract with progress bar.

Calmira Commander
 * Two panels, F5 copy, F6 move, F8 delete, Alt+F5 pack to ZIP,
   Alt+F9 unpack ZIP, command line (just start typing).
 * Dialog to choose the ZIP name and destination, with a progress bar.

Other programs
 * Pad: plain text editor that understands long file names.
 * Writer: RTF documents with fonts and character formatting.
 * View: zoom, full screen, slide show, mouse wheel, JPEG (also
   progressive), BMP, PNG, GIF.
 * Player: MP3 and WAV, playlist saved permanently, ID3 tags.
 * Clipboard: icon in the tray, quick list, history.
 * Task manager: list of tasks, switch to / end task.

System
 * Settings: language, look, Start menu, file associations, tips.
 * Control Panel applets run inside the shell, hardware and system
   properties, display resolution and colour depth.
 * Tip of the Day, Exit Calmira from the Shut Down dialog.
 * Languages: English, Slovak, German, French (switch in Settings).
 * One-file setup with language choice, Program Manager group, file
   associations and a complete uninstaller.


INSTALLATION
------------
 Run SETUP.EXE, pick the language and the folder, confirm. If you chose
 "Use Calmira as the Windows shell", SYSTEM.INI gets shell=CALSHELL.EXE
 and the computer is restarted (a full restart, not just Windows) when
 the installation ends. The old shell is restored by uninstalling; a
 backup of SYSTEM.INI is kept as SYSTEM.CIN in the Windows folder.
 CALSHELL.EXE is only copied when this option is chosen.

 UPDATING: start the new SETUP.EXE from inside Calmira (Start - Run). Setup
 asks, closes Calmira, replaces the files, keeps your settings (*.INI) and
 starts Calmira again. If Calmira is the shell (shell=CALSHELL.EXE), Windows
 keep running meanwhile. An older installation that still has
 shell=...NEXTGEN.EXE is switched to CALSHELL.EXE by one normal
 installation from DOS or Program Manager.

 To uninstall use the "Uninstall" icon in the Calmira NextGen group or run
 SETUP.EXE /U from the install folder.

 To go back by hand: in SYSTEM.INI, section [boot], set shell=PROGMAN.EXE.


CONFIGURATION
-------------
 NEXTGEN.INI   Shell settings (language, style, icon positions, startup).
 START.INI     Start menu contents.
 Both are plain text files in the install folder.

 Diagnostics: Calmira writes NEXTGEN.LOG in the install folder at every start
 (a new file each time): the computer and Windows setup (CPU, memory,
 display driver and mode, mouse, drives, Windows file versions, the
 [boot], [boot.description], [386Enh] parts of SYSTEM.INI, your Calmira
 settings) and the main steps that run. If something goes wrong, send this
 file with your report. [Settings] Log=2 in NEXTGEN.INI adds paint steps,
 Log=0 turns the file off.


DISCLAIMER
----------
 This software is provided "as is", without warranty of any kind. Use at
 your own risk. Calmira is a trademark of its respective owner; Windows is a
 trademark of Microsoft Corporation. This project is not affiliated with or
 endorsed by Microsoft or by the authors of Calmira II.

Skins
-----
Look (Modern / Flat / Classic) and skins are chosen in Display Properties > Background. A skin is a file SKINS\NAME.INI:
  [Skin]
  Name=Graphite
  [Colors]            ; r,g,b
  Panel=28,28,28
  Hot=66,66,66
  Accent=255,128,0
  Pressed=12,12,12
  Separator=76,76,76
  [Colors8]           ; optional, for 16/256 colours
If the SKINS folder is missing or a file is broken, the standard flat colours are used.
The Start button picture (icons\start16.ico, start256.ico) is used in every look except Classic.
