Lupa
====
Press Left Amiga + Space, type a few letters, hit Return.
Lupa is a search bar for AmigaOS, inspired by Spotlight on the modern
Mac. It keeps a small index of your drives in the background, so as you
type it shows programs, WHDLoad games, documents, preferences, Shell
commands, drawers and disks (and, with Shapeless, the Mac's applications
and documents). Return opens the selected one; Amiga+Return opens the
drawer it lives in.
It works alongside your game launcher, not instead of it: Lupa reads the
game lists of PocketLauncher, iGame and TinyLauncher so any game is a few
letters away. To browse the whole collection with covers and filters we
recommend PocketLauncher (game/misc/PocketLauncher).
* Runs on a stock 68000 with 2 MB of Fast RAM, Kickstart 2.04 and up.
OCS, ECS, AGA or a graphics card (truly transparent on RTG).
* Finds every drawer at any depth, with or without an icon.
* Works on OFS, FFS, PFS, SFS, FAT and CD filesystems.
* Leaves floppies, CDs and USB sticks alone unless you ask.
* A power cut never leaves a broken index: the previous one stays good.
* English by default; Spanish through the locale catalog.
* Lupa-Prefs for the hotkey and look; Lupa-Update checks for new
versions (signed, never runs by itself).
* Drawers open in the Workbench, Scalos, Directory Opus 5 or 4.
Changes in 1.1.5
----------------
* Directory Opus 5 (as Workbench replacement): drawers now open right
(the lister got the path with quotes around it).
* Directory Opus 4: drawers open too (before, nothing happened).
* New Installer script: plain text you can read, and you choose where
Lupa goes and where Lupa-Prefs and Lupa-Update go.
* Lupa-Prefs and Lupa-Update can live in any drawer; updates keep them
there, also if you moved them yourself.
* Lupa-Prefs fits big screen fonts (topaz 8 if it would not fit).
* Smoother rounded search field with tall screen fonts.
* $VER date readable by C:Version on 3.0/3.1.
The archive has the Lupa drawer: double-click "Install" (Commodore
Installer) or "Install-Lupa" (Lupa's own installer, also for 2.04).
A single-file installer is also on the website.
Website: https://lupalauncher.com
LANGUAGE
Lupa speaks English. With Workbench 2.1 or later and Spanish chosen in
the Locale preferences, Lupa, Lupa-Prefs, Lupa-Update and the installer
speak Spanish: the installer copies the catalog to
LOCALE:Catalogs/espanol/lupa.catalog (the folder name has an n with a
tilde, as the system writes it). On 2.04 there is no locale.library:
English only.
INSTALL
Two ways, same result (pick one):
- "Install": a script for the Commodore Installer (in C: or
SYS:System on 3.x; on 3.1 it is on the Install disk). Plain text:
you can read what it does before running it. It asks where Lupa
goes and where Lupa-Prefs and Lupa-Update go (SYS:Prefs or any
drawer you like).
- "Install-Lupa": Lupa's own installer, also for 2.04 without the
Installer. It checks every file byte by byte and rolls back if
anything fails.
Install-Lupa:
Double-click "Install-Lupa". It suggests the recommended choices (and
says why):
- where: WBStartup (recommended: starts with the Workbench and is ready
with the hotkey), another drawer, or SYS:Tools/Commodities without
starting by itself;
- the hotkey: Left Amiga + Space (recommended), Ctrl + Space or
Alt + Space for PC keyboards without an Amiga key;
- start it now (it starts indexing in the background).
If Lupa is already installed, it updates it in the same place: the
hotkey, the settings and the indexes stay as they were.
From the Shell:
Install-Lupa [TO=WBSTARTUP|TOOLS|<drawer>] [HOTKEY="control space"]
[START] [QUIET] [PREFSTO=<drawer>]
What it does: picks Lupa or Lupa.000 for your CPU; quits a running Lupa
(waits up to 30 s); copies every file to a temporary name and checks it
byte by byte before replacing anything (if the disk is full or
write-protected, it says so and changes nothing); keeps what was there
before in SYS:Lupa-Respaldo; never touches ENVARC:Lupa.prefs or the
indexes. Lupa-Prefs and Lupa-Update go to SYS:Prefs, or to PREFSTO=
(both installers remember that drawer, and updates keep them there,
also if you moved them there yourself). Log:
Lupa-Instalar.log (next to the installer, or in T:). It does not touch
the Startup-Sequence or the User-Startup.
The single-file installer (Install-Lupa on its own) carries the whole
package inside; "Install-Lupa EXTRACT=RAM:Lupa" unpacks it (this README
included) without installing anything.
UNINSTALL
Double-click "Uninstall-Lupa" (or "Install-Lupa UNINSTALL" from the
Shell): it removes Lupa, its indexes, its settings and the catalog, and
puts back what was there before you installed it. Keep this drawer (or
the installer) if you may want to uninstall later.
UPDATE OVER THE INTERNET
Lupa-Update, in SYS:Prefs or the drawer you chose (or "Check for
updates..." in Lupa-Prefs).
It needs TCP/IP running. It downloads a new version only if it is signed
by Pal-N Studios, checks all of it and installs it with the same
installer (backup and roll back). Without a network it says so and
changes nothing. It never runs by itself.
Lupa-Update CHECK only tells you whether there is a new one
THE FIRST TIME
Lupa indexes by itself, in the background, at low priority. You can
search and open things while it indexes: the bar never waits for the
indexer.
If it finds PocketLauncher, iGame or TinyLauncher, it can use their game
lists (all together, without duplicates) and asks you in the bar:
Return takes the marked option, the arrows change it, Esc leaves it for
later. Until you answer, Lupa keeps indexing and you can search.
"No, scan the disks" makes Lupa read the game folders itself.
After that it keeps itself up to date:
- when a folder changes (system notification; it waits 5 s and reindexes
only that disk);
- when you insert or remove a disk;
- every 30 minutes while the Amiga is idle (68020 and better; IDLEMIN),
a quick check that stops as soon as you touch a key or the mouse.
WHAT IT FINDS
Programs, games, documents, preferences and Shell commands, plus every
drawer it walks through, with or without an icon, at any depth (up to
DEPTH, 8 by default): type "recib" and the "Received" drawer some program
made shows up. Each disk is a result too: "work" offers Work:.
Game folders do not show up as drawers: the game does.
DISKS THAT ARE NOT THERE
Lupa never launches something that no longer exists: if you deleted it,
Lupa drops it from the index and, if there is another one with the same
name, offers it. If its disk is not mounted, it tells you ("The disk X
is not mounted") without asking for it.
Things on a disk you remove disappear from the bar right away. Disks that
are not mounted are hidden (AUSENTES=GRIS shows them greyed out), and the
index of a disk not seen for 90 days is deleted (PODAR).
Floppies, CDs, USB and network disks are not indexed unless you ask
(the "Index floppies, CDs and USB" box in Lupa-Prefs, INDEXAR_EXTRAIBLES=1
or EXTRAIBLES=DF0:,CD0:).
KEYS IN THE BAR
Arrows: choose Return: open Amiga+Return: open its drawer
Drawers open in the Workbench (3.5 and later), Scalos, Directory Opus 5
or Directory Opus 4 (whichever is running), or in Lupa's own window.
Tab / Shift+Tab: next / previous section Esc: close
Backspace: delete a letter Del: clear everything
PREFERENCES: Lupa-Prefs (SYS:Prefs, or the drawer you chose)
Hotkey (Left Amiga + Space, Ctrl + Space, Alt + Space, Ctrl + Alt + L,
or another one in commodities syntax, e.g. "control space"), look
(Automatic / Transparent / Solid / Minimal), panel (Light / Dark /
System = the Workbench colours) and position (Center / Top).
"Index floppies, CDs and USB": off (the default) Lupa does not touch
them; on, it indexes them while they are inserted.
Use / Save: Lupa takes them at once, without restarting.
An invalid hotkey is not saved; if Lupa finds one that is not valid, it
uses Left Amiga + Space and says so once in the bar.
On a PC keyboard (riser, adapter), Left Amiga is usually left Windows.
Automatic = transparent on RTG, solid on AGA/ECS (transparency only
exists on RTG).
SETTINGS (ENVARC:Lupa.prefs; most also as icon tooltypes, KEY=value)
The keys keep their original (Spanish) names.
The hotkey: what Lupa.prefs says (Lupa-Prefs) wins; the HOTKEY (or
CX_POPKEY) tooltype counts only if Lupa.prefs has no HOTKEY; CX_POPKEY=
from the Shell wins over everything. For the other keys the tooltype wins.
HOTKEY=lcommand space the hotkey
ASPECTO=AUTO look: TRANSPARENTE / SOLIDO / MINIMO
PANEL=CLARO panel: OSCURO (dark) / SISTEMA (system)
POSICION=CENTRO position: ARRIBA (top)
ROOTS=SYS:,Work:,Games: where to look (by default, every disk)
DEPTH=8 how many drawer levels deep
GAMES=ASK|IMPORT|OWN games: ask / launcher lists / its own scan
LANZADORES=1:path|3:path launcher databases (1 PocketLauncher,
2 TinyLauncher, 3 iGame); Lupa writes it
when it asks
INDEXAR_EXTRAIBLES=1 index floppies, CDs, USB and cards (also the
box in Lupa-Prefs). Off (the default), Lupa
does not touch them: not even a floppy click
EXTRAIBLES=DF0:,CD0: or only those
AUSENTES=GRIS disks not mounted: greyed out (default: hidden)
PODAR=90 forget disks not seen for N days
IDLEMIN=30 idle check every N minutes (0 = never)
CACHEKB=16 memory for reading the index (8 to 128 KB)
MAC=0 do not index the Mac
MACDICC=file dictionary of Mac programs (LupaMac.dic)
WBLAUNCH=OWN always launch with Lupa's own method
ICONOS=0 no icons (only the drawing for each kind)
SALTEAR=Vol1,Vol2 disks that are never indexed
Emergency brake: SetEnv LUPANOCX 1 (Lupa does not start)
Debug log: SetEnv LUPALOG 1 (writes T:Lupa.log)
(SetEnv LUPALOG RAM:x.log for another file; never in a drawer that Lupa
indexes: every line would be a change and it would reindex forever)
SAFE MODE
If Lupa crashes with a Guru in the middle of something, next time it does
not repeat it, and it says so at the foot of the bar:
- reading an icon: that .info is not read again (Lupa.vol/IconosMalos;
after three, ICONOS=0);
- with the bar open: ASPECTO=MINIMO and ICONOS=0, and the history goes
to Lupa.use.malo;
- while indexing a disk: its index is rebuilt; if it happens again, that
disk goes into SALTEAR.
A power cut or a reset is not Lupa's fault: it is only noted
(Lupa.vol/Caidas), and the indexes are always written whole.
To undo: Lupa-Prefs (look), and ICONOS=1 and an empty SALTEAR= in
ENVARC:Lupa.prefs.
FROM THE SHELL
Lupa INDEX [FULL] index Lupa TEST "text" try a search
Lupa UIBENCH "text" time the bar Lupa LAUNCHERS game launchers
Lupa STATS indexes Lupa QUIT quit Lupa
Lupa RECARGAR reread hotkey and look from Lupa.prefs
Lupa OPENDIR=<drawer> open a drawer the way the bar would
|
aminet net>