Icône BASIC 1983

BASIC 1983. Le guide.The guide.

Vingt et un chapitres : quatorze points, écran par écran et bouton par bouton, puis les 80 programmes de la galerie, un par un. C’est le même guide que dans l’app. Le lexique, dans l’app, décrit le langage lui-même.Twenty-one chapters: fourteen points, screen by screen and button by button, then the 80 gallery programs, one by one. It is the same guide as in the app. The lexicon, in the app, describes the language itself.

BASIC 1983, mode d’emploi

Vingt et un chapitres, comme dans l’app (engrenage, « Guide de l’app ») : quatorze points, écran par écran et bouton par bouton, dans l’ordre où l’on découvre la machine, puis les 80 programmes de la galerie, catégorie par catégorie.

🖥️ La machine

  • BASIC 1983 est un carnet pour apprendre le BASIC de 1983. Vous voyez le tube (l’écran cathodique), le clavier, la manette, le bouton FIRE et le flanc : cinq touches, RESET, OPTION, SELECT, START et HELP.
  • À l’allumage, le tube écrit READY. Cela veut dire : la machine attend que vous tapiez quelque chose.
  • Tout ce que vous tapez est du BASIC de 1983. Il n’y a rien à installer, rien à configurer.
  • C’est aussi une façon simple d’apprendre à programmer : le BASIC tient en quelques dizaines de mots, chaque ligne fait une chose, et le résultat se voit tout de suite sur le tube. Ceux qui ont connu ces machines y retrouveront leurs gestes.

1️⃣ Premiers pas, en quatre gestes

  • 1. Passez en mode ÉCRAN (le premier des trois boutons au milieu de la barre du haut), puis touchez la pastille clavier au-dessus du tube. Le clavier de 1983 monte.
  • 2. Tapez PRINT 2+2 puis RETURN. Le tube répond 4, puis READY.
  • 3. Tapez 10 PRINT "BONJOUR" puis RETURN, puis 20 GOTO 10 puis RETURN. Rien ne s’affiche : une ligne qui commence par un numéro est rangée dans le programme, elle n’est pas exécutée tout de suite.
  • 4. Tapez RUN puis RETURN. BONJOUR défile sans fin. Pour arrêter : la touche BREAK du clavier, ou la croix en haut à droite qui ramène à l’éditeur.

🧭 Les trois modes

  • Les trois boutons au milieu de la barre du haut changent la vue.
  • ÉCRAN : la machine seule, en grand, avec la manette et FIRE. Pour jouer, et pour taper sur le tube.
  • MIXTE : le tube en haut, l’éditeur en bas. Pour écrire un programme et le voir tourner.
  • CODE : l’éditeur seul, pour les longs programmes.
  • En ÉCRAN, la croix en haut à droite revient à l’éditeur.

🔝 La barre du haut, de gauche à droite

  • Engrenage : les réglages rapides (sons, effets d’écran, iCloud…) et ce guide.
  • Dossier orange : Fichiers et programmes. La galerie des programmes, Nouveau programme, Mes programmes, K7.
  • Livre bleu : le lexique. Tous les mots du BASIC en liste ; touchez un mot pour ouvrir sa fiche, avec sa syntaxe et un exemple à essayer.
  • ÉCRAN · MIXTE · CODE : les trois modes.
  • Tortue, Lièvre, Éclair : la vitesse de la machine, AUTHENTIQUE, NORMAL ou TURBO (voir Réglages).
  • Flèche orange : RESET. La machine redémarre, le programme reste.
  • Triangle vert : lance le programme. Il devient un carré rouge pour l’arrêter.

🔘 Les pastilles au-dessus du tube (mode ÉCRAN)

  • Appareil photo : une photo du tube, une vidéo avec le son, ou le son seul. Pendant un enregistrement la pastille devient rouge : touchez-la pour arrêter et partager.
  • Clavier : monte ou baisse le clavier de 1983. Un appui long bascule vers le clavier iOS, et retour.
  • Manette : montre ou cache la manette et FIRE.
  • Flanc : montre ou cache les cinq touches RESET, OPTION, SELECT, START, HELP.
  • Tortue ou lièvre : la vitesse.
  • Croix : retour à l’éditeur. Si un programme tourne, elle l’arrête aussi.
  • En paysage sur iPhone, les pastilles se rangent dans les marges, de part et d’autre du tube : la croix, la vitesse et le flanc en haut à gauche, les autres en haut à droite, loin de FIRE et de la manette.

⌨️ Le clavier de 1983

  • Tout ce que vous tapez s’écrit sur le tube. RETURN envoie à la machine la ligne où se trouve le curseur.
  • Vous pouvez remonter sur une ligne déjà affichée (flèches : CTRL avec -, =, + ou *), la corriger, et refaire RETURN. C’est ainsi qu’on corrigeait un programme en 1983.
  • SHIFT donne le symbole écrit en haut de la touche. CTRL avec une lettre donne un caractère graphique. La machine écrit en capitales : c’est normal, c’est son verrou CAPS.
  • BREAK arrête un programme qui tourne. CTRL puis 1 suspend son affichage et le témoin POWER passe en PAUSE ; encore CTRL puis 1 pour reprendre. Un programme qui pose une question (INPUT) fait monter le clavier tout seul.

📝 L’éditeur (modes MIXTE et CODE)

  • Chaque ligne commence par un numéro. +LINE ajoute le numéro suivant. RENUM renumérote tout le programme proprement. SÉL.TOUT sélectionne tout le listing et EFFACER supprime ce qui est sélectionné : pour vider l’éditeur, touchez l’un puis l’autre. Quand un clavier est levé, un bouton clavier apparaît à gauche de SÉL.TOUT : il le baisse.
  • La barre de mots-clés, sous l’éditeur, contient tous les mots du BASIC de la machine, dans l’ordre alphabétique : un toucher écrit le mot. Pendant la frappe, elle glisse vers les mots qui commencent comme ce que vous tapez et les met en orange : toucher l’un d’eux finit le mot. Une fonction s’écrit avec sa parenthèse ouverte, STICK( : tapez l’argument et fermez la parenthèse. Sur iPhone, deux onglets sous l’éditeur : CODE, le programme, et MÉMOIRE, la liste des variables avec leurs valeurs.
  • Ce que vous tapez dans l’éditeur est aussitôt dans la machine : il n’y a qu’un seul programme, le même dans l’éditeur et sur le tube.
  • Triangle vert : lance. Carré rouge : arrête. Flèche orange (RESET) : redémarre la machine en gardant le programme.
  • Une ligne fausse est signalée : tout de suite si vous la tapez sur le tube, au moment du RUN si vous l’avez écrite dans l’éditeur.

⚠️ Quand ça ne marche pas

  • Le tube écrit ERROR- n AT LINE m : n est le numéro de l’erreur, m la ligne où elle s’est produite. Le lexique (livre bleu) explique chaque numéro d’erreur.
  • Un programme plein écran (GRAPHICS avec +16) doit tourner en boucle : dès qu’il se termine, le READY ramène l’écran texte. C’était pareil en 1983.
  • Le texte du tube est trop petit ? La petite loupe au coin du tube, ou un double tap sur le tube, ouvre une loupe. Une bulle rappelle les gestes : le doigt la déplace, un double tap la ferme.
  • Le son s’est tu après un appel ou un changement d’enceinte ? Il revient au prochain SOUND ou au prochain clic.

🎮 Jouer

  • La manette est à gauche, FIRE à droite. Dans un programme, STICK(0) lit la manette, STRIG(0) lit FIRE, PADDLE(0) lit le doigt qui glisse sur le tube, en mode ÉCRAN.
  • Le flanc, au READY : START lance le programme, SELECT ouvre la galerie, OPTION ouvre les préférences, HELP ouvre le lexique, RESET redémarre.
  • Dans un programme, PEEK(53279) lit START, SELECT et OPTION ; PEEK(732) lit HELP.

💻 Sur Mac, ou avec un clavier

  • Sur Mac (Designed for iPad) et sur iPad avec un clavier, tout se fait aussi au clavier et à la souris. Sans clavier, rien ne change.
  • Pendant un programme : les flèches sont la manette, diagonales comprises, et la barre d’espace est FIRE. La manette dessinée reste utilisable ; la touche tenue l’emporte.
  • Au READY ou pendant un INPUT : on tape sur l’écran — lettres, chiffres, Entrée, retour arrière, TAB, ESC — et les flèches déplacent le curseur, comme CTRL+flèche en 1983.
  • Le flanc (START, SELECT, OPTION, HELP, RESET), BREAK et les menus se cliquent. Double-clic sur le tube : la loupe. Le copier-coller fonctionne dans l’éditeur.

📁 La galerie et mes programmes

  • Dossier orange, Galerie des programmes (ou la touche SELECT) : vos programmes, puis 80 exemples en sept catégories, BASICS, GRAPHICS, SOUND, ATELIER, GAMES, GRANDS CLASSIQUES, DEMOS. La galerie s’ouvre sur ses rubriques : touchez-en une pour la déplier, la recherche retrouve un programme par son titre. Sur chaque ligne, RUN lance le programme tout de suite ; touchez son nom pour lire ce qu’il fait, et LOAD le met dans l’éditeur. L’étoile met le programme en favori : il passe en tête de sa catégorie, et la rubrique FAVORIS ne montre que les favoris.
  • ATELIER : des programmes cassés exprès. À vous de trouver l’erreur et de la réparer.
  • Les jeux : START ou le tir lance la partie, OPTION la met en pause, et le meilleur score reste en mémoire (page 6) tant que la machine est allumée.
  • Dossier orange, Mes programmes : Enregistrer dans le stockage garde votre programme avec un nom, une catégorie et des étiquettes. Gérer les programmes retrouve, trie (date, nom, favoris d’abord), renomme, met en favori et supprime. Charger depuis le stockage le remet dans l’éditeur.
  • L’éditeur est un brouillon. Enregistrer dans le stockage crée toujours un nouveau programme, sous le nom que vous choisissez. Si ce nom existe déjà, l’app demande : Remplacer ou Garder les deux.
  • Un point en haut de l’éditeur signale un programme qui n’est pas encore enregistré. Si vous en chargez un autre à ce moment-là, l’app demande d’abord Enregistrer le programme ?
  • En quittant l’app, votre programme reste tel quel : vous le retrouvez au lancement suivant.
  • Dossier orange, Mes programmes, en bas : importer ou exporter un fichier .TXT, partager le programme.
  • Avec iCloud (activé d’office, réglable dans PRÉFÉRENCES), vos programmes enregistrés vous suivent sur tous vos appareils.
  • Ce que fait chaque exemple, et la règle de chaque jeu : plus loin dans ce guide, un chapitre par catégorie.

📼 La K7, la cassette (CSAVE, CLOAD)

  • CSAVE, tapé sur le tube (ou Dossier orange, K7, Enregistrer sur K7) : la machine bipe deux fois et range une K7 dans la boîte, au nom du programme.
  • CLOAD, tapé sur le tube (ou Dossier orange, K7, Charger une K7) : la machine bipe une fois, la boîte s’ouvre, vous touchez une K7 et le programme est chargé.
  • Une K7 est un vrai fichier son. La boîte à K7 la joue, la partage, la renomme, la supprime. On y importe aussi une vraie K7 d’époque : un fichier son numérisé depuis un lecteur, ou un fichier CAS d’archive.
  • Les K7 sont aussi visibles dans l’app Fichiers.
Vers une vraie machine : « Jouer vers une vraie machine » envoie le son de la cassette par la prise casque (adaptateur filaire) vers un adaptateur cassette glissé dans un lecteur d’époque, la machine étant en attente après CLOAD puis RETURN. Le signal suit le format d’époque, mais cet essai n’a pas encore été fait sur une machine d’origine. Cette page sera mise à jour quand il le sera.

⚙️ Réglages (PRÉFÉRENCES, touche OPTION au READY)

  • Langue (français ou anglais) ; clavier du tube (1983 ou iOS) ; thème ; police du tube (1983 en points, ou lisse) ; sons d’interface ; police de l’éditeur.
  • Le thème colore tout l’écran tant qu’un programme ne règle pas ses couleurs. Dès qu’il règle le fond ou la bordure (SETCOLOR 2 ou SETCOLOR 4), l’écran montre les vraies couleurs, les mêmes dans tous les thèmes.
  • Effets CRT : lignes, halo, courbure. Contrôles : mains inversées, taille du stick. Zoom de la loupe. Amorce de la K7.
  • Vitesse : AUTHENTIQUE, c’est la vitesse de 1983 ; NORMAL, quatre fois plus vite ; TURBO, au plus vite, pour les démos qui calculent beaucoup.
  • iCloud : synchroniser ou non les programmes enregistrés et quelques réglages avec votre compte.
  • Aide : le guide de l’app, le lexique, et À propos (version, nouveautés, politique de confidentialité, site web, e-mail).

💡 Astuces d’époque

  • PRINT CHR$(125) efface l’écran.
  • Les abréviations à point gagnent du temps : PR. pour PRINT, GR. pour GRAPHICS, PL. pour PLOT. LIST les réécrit en entier.
  • SOUND 0,0,0,0 coupe une voix. TRAP n envoie le programme à la ligne n en cas d’erreur, au lieu de s’arrêter.
  • Après une dizaine de minutes sans toucher à rien, les couleurs changent toutes seules et s’assombrissent : c’est la protection d’écran de 1983. Une touche, la manette ou FIRE les ramène.

📚 Les programmes de la galerie, un par un

Ce que fait chaque exemple, et la règle de chaque jeu.

BASICS

Les premiers mots du BASIC, un programme pour chacun.

  • HELLO WORLD : écrit huit fois HELLO WORLD avec une boucle FOR.
  • COUNT 1-10 : compte de 1 à 10.
  • IF/THEN : compte jusqu’à 20 et écrit BIG dès que le nombre dépasse 10.
  • FIBONACCI : la suite où chaque nombre est la somme des deux d’avant, jusqu’à 100.
  • GUESS NUMBER : la machine choisit un nombre de 1 à 10, à vous de le trouver.
  • INPUT NAME : demande votre nom, vous salue et compte ses lettres.
  • DATA LIST : lit une liste de fruits et de quantités rangée dans une ligne DATA.
  • MENU (ON) : un menu à trois choix, avec ON … GOTO.
  • ASCII ART : écrit l’alphabet à partir des codes 65 à 90, avec CHR$.
  • TEXT SLICER : découpe un texte en morceaux et en remplace un.
  • DEG / RAD / FRE : le même sinus en degrés puis en radians, et la mémoire libre.
  • JOYSTICK TEST : écrit UP, DOWN, LEFT, RIGHT ou FIRE selon ce que vous faites à la manette.
  • KEY TEST (GET) : affiche le code de chaque touche tapée. Q pour quitter.
  • GRID (2D) : remplit un tableau de 4 sur 4, puis l’affiche.
  • FONCTIONS MATHS : EXP, LOG, CLOG et ATN essayés sur quatre nombres.
  • NOMBRES ET TEXTE : passe d’un nombre à un texte et retour (STR$, VAL), et repère les nombres qui se lisent pareil à l’envers.
  • PAS A PAS : s’arrête avec STOP, repart quand vous tapez CONT, et sort d’une boucle avec POP.
  • AUTOPORTRAIT : le programme liste ses propres lignes, puis montre PUT, STATUS et CLR.

GRAPHICS

Des dessins courts, pour découvrir les modes graphiques.

  • DRAW BOX : trace un rectangle en quatre traits.
  • COLOR BARS : douze barres dans les trois couleurs de GRAPHICS 7.
  • CIRCLE PI : un cercle en pointillé, calculé avec le nombre pi.
  • CHAOS FRACTAL : 2000 points tirés au hasard, qui finissent par dessiner un triangle fait de triangles.
  • RAYONS : 36 rayons qui partent du centre de l’écran.
  • RANDOM RECT : des rectangles au hasard, sans fin.
  • RAINBOW (SETCOLOR) : des traits qui passent par les seize teintes, l’une après l’autre.
  • ORAGE : des éclairs dans tous les sens, en couleurs, et le tonnerre.
  • GR.7 + FILL (XIO) : un rectangle rempli d’un seul coup avec XIO 18.
  • MODES 3 A 8 : le même dessin dans les modes graphiques 3 à 8, du point le plus gros au plus fin.
  • DESSIN AU JOYSTICK : une ardoise. La manette trace, FIRE change de couleur, START efface tout.

SOUND

À écouter : des bruitages, puis de la musique sur les quatre voix de SOUND.

  • SOUND DEMO : une voix qui glisse de l’aigu au grave.
  • STEAM ENGINE : le souffle d’une locomotive à vapeur, sans fin.
  • ROBOT BLIPS : vingt bips au hasard, comme un robot qui parle.
  • SIREN : une sirène qui descend et qui remonte, sans fin.
  • HELICOPTER : le battement des pales d’un hélicoptère.
  • ACCORD 4 VOIX : un accord de do majeur sur les quatre voix, qui s’éteint doucement.
  • BASSE + MELODIE : huit notes de mélodie sur une basse tenue, jouées trois fois.
  • AH VOUS DIRAI-JE MAMAN : la comptine, note après note, sur une seule voix.
  • CANON DE PACHELBEL : trois violons entrent l’un après l’autre sur huit notes de basse.
  • COMPOSITEUR : choisissez tonalité, mode, style et tempo, ou 0 pour le hasard. La machine compose un morceau juste et le joue. À la fin, quatre touches au clavier de la machine : rejouer, nouveau, réglages ou fin.

ATELIER

Dix programmes cassés exprès. Lancez, lisez l’erreur, réparez la ligne, relancez.

  • LE NEXT PERDU : doit afficher 1 à 5. Regardez le NEXT.
  • LA CHAINE OUBLIEE : doit dire bonjour. Un texte a besoin d’un DIM.
  • LA DIVISION FOLLE : doit diviser 100 par N. N n’a jamais reçu de valeur.
  • LE SAUT DANS LE VIDE : doit compter 1, 2, 3. Le GOTO vise une ligne qui n’existe pas.
  • LA LIGNE ILLISIBLE : doit afficher le double de 21. La ligne 80 est à retaper.
  • LE CANAL FERME : doit lire une touche. GET veut un canal ouvert par OPEN.
  • LES DATA EPUISEES : doit lire quatre prix. Comptez les DATA.
  • LE RETOUR SANS APPEL : doit saluer puis s’arrêter. Rien n’arrête le programme avant le sous-programme.
  • LA CHAINE TROP COURTE : doit épeler BASIC. Le DIM est trop petit.
  • LE PINCEAU HORS CADRE : doit tracer un trait. En GRAPHICS 7, X s’arrête à 159.

GAMES

Dans ces neuf jeux, START ou FIRE lance la partie, OPTION la met en pause, et le record est gardé.

  • SUPER JUMP : courez vers la droite et sautez les obstacles avec FIRE ou la manette vers le haut. Retomber sur l’ennemi l’écrase et rend du temps. Arrivez au bout avant la fin du temps.
  • METEOR STORM : évitez les météores qui tombent, manette à gauche et à droite.
  • MOON LANDER : posez-vous en douceur sur la plateforme claire. Manette vers le haut pour la poussée, à gauche et à droite pour dériver. Le carburant est compté.
  • SPACE DEFENDERS : manette à gauche et à droite, FIRE tire. Deux rangées lâchent des bombes, trois boucliers vous abritent, une soucoupe passe parfois. Les munitions sont comptées : à court, vous perdez une de vos trois vies.
  • PADDLE BALL : renvoyez la balle, manette à gauche et à droite. Un niveau tous les dix renvois, et la balle accélère.
  • CANYON RUN : descendez le canyon sans toucher les parois, manette à gauche et à droite.
  • UFO HUNT : la manette déplace le viseur, FIRE tire. Vous avez soixante secondes pour toucher soucoupes et vaisseau mère, sans tirer sur l’avion blanc. Cinq cibles font un niveau et rendent dix secondes.
  • PANIER : attrapez les pommes dans le panier, à la manette ou en glissant le doigt sur le tube. Un niveau toutes les cinq pommes, et elles tombent plus vite. Trois pommes ratées et c’est fini.
  • ALIEN CARGO : manette à gauche et à droite, FIRE tire sur le cargo ou sur ses bombes. Évitez les bombes et, dès le niveau 2, le rayon qui paralyse. Trois vies, et une de plus tous les 1000 points.

GRANDS CLASSIQUES

Des programmes longs, comme ceux qu’on recopiait dans les magazines.

  • SNAKE : à l’écran-titre, START lance, SELECT règle la vitesse, OPTION met ou enlève les murs. La manette dirige le serpent : mangez les pommes sans vous toucher.
  • CASSE-BRIQUES : renvoyez la balle pour casser les 32 briques, manette à gauche et à droite. Trois vies. La balle part tout de suite.
  • JACQUES A DIT : regardez la suite, puis refaites-la à la manette : haut, bas, gauche, droite. Elle s’allonge à chaque niveau, jusqu’à dix.
  • PENDU : trouvez le mot lettre par lettre, au clavier. Sept erreurs et c’est perdu.
  • LABYRINTHE : la machine creuse un labyrinthe sous vos yeux. Ensuite, à la manette, trouvez la sortie en bas à droite. Le temps est compté.
  • MORPION : vous jouez les X contre la machine. Tapez le numéro de la case, de 1 à 9.
  • QUATRE EN LIGNE : à deux, ou seul contre la machine sur trois niveaux. Au menu, tapez 1 ou 2 au clavier de la machine ; ensuite la manette et FIRE, ou les touches 1 à 7, lâchent un pion. Alignez-en quatre.
  • CALCUL MENTAL : dix questions au chrono, sur trois niveaux. Le record de chaque niveau est gardé.

DEMOS

À regarder et à écouter. Celles qui calculent beaucoup vont mieux en TURBO.

  • CUBE 3D : un cube en fil de fer qui tourne. Plus fluide en TURBO.
  • TUNNEL : des carrés emboîtés dont les couleurs tournent : on croit avancer dans un tunnel.
  • COUCHER DE SOLEIL : le soleil sur la mer en seize nuances (GRAPHICS 9), avec un reflet qui scintille.
  • PRELUDE DE BACH : le prélude en do majeur de Bach (1722), à trois voix.
  • FEU D’ARTIFICE : des fusées qui montent et éclatent en couleurs, avec le bruit.
  • ARBRE FRACTAL : un arbre qui pousse, branche après branche.
  • KALEIDOSCOPE : un dessin repris par huit miroirs, avec des couleurs qui tournent.
  • MOIRE : des lignes fines qui se croisent et font apparaître des vagues.
  • VITRAIL : des triangles pleins, posés au hasard comme les morceaux d’un vitrail.
  • SPIROGRAPHE : des rosaces comme celles du jouet à roues dentées.
  • SOMBRERO 3D : une surface en relief, en forme de chapeau. Le calcul est long : NORMAL ou TURBO.
  • PIANO : jouez au clavier : A (ou Q), S, D, F, G, H, J, K, ou 1 à 8, pour do, ré, mi, fa, sol, la, si, do.
  • HORLOGE : un chronomètre à aiguille : la trotteuse tourne, les minutes se comptent.
  • LE JEU DE LA VIE : des cases naissent et meurent selon trois règles. Choisissez un départ, de 1 à 4, et regardez : vert vit, jaune naît, rouge meurt.

🧭 Partis pris

BASIC 1983 est un interpréteur original, sans affiliation avec un constructeur. Le langage suit une spécification tirée de la documentation d’époque et vérifiée par une recette automatique ; les écarts connus sont documentés. Les exemples de la galerie sont écrits pour l’app.

🔒 Aucun compte, aucune inscription, aucun accès au réseau : l’app fonctionne hors ligne, sans publicité, sans achat intégré et sans outil de mesure d’audience. iCloud, en option, ne fait que copier vos programmes et quelques réglages dans votre propre compte.

📱 Configuration requise

  • iOS 18.6 ou version ultérieure
  • iPhone et iPad, en portrait comme en paysage
  • Aucune connexion Internet requise
  • Français et anglais, permutables dans les Préférences
  • Aucune autorisation demandée : ni micro, ni photos, ni position

✉️ Support

Une question, une remarque, une suggestion ? Écrivez-nous via le formulaire de contact.

BASIC 1983, how to use it

Twenty-one chapters, as in the app (gear, “App guide”): fourteen points, screen by screen and button by button, in the order you discover the machine, then the 80 gallery programs, category by category.

🖥️ The machine

  • BASIC 1983 is a notebook for learning 1983 BASIC. You see the tube (the CRT screen), the keyboard, the joystick, the FIRE button and the flank: five keys, RESET, OPTION, SELECT, START and HELP.
  • At power-on the tube prints READY. It means: the machine is waiting for you to type something.
  • Everything you type is 1983 BASIC. Nothing to install, nothing to configure.
  • It is also a simple way to learn programming: BASIC fits in a few dozen words, each line does one thing, and the result shows right away on the tube. Those who knew those machines will find their old habits again.

1️⃣ First steps, in four moves

  • 1. Switch to SCREEN mode (the first of the three buttons in the middle of the top bar), then touch the keyboard pill above the tube. The 1983 keyboard rises.
  • 2. Type PRINT 2+2 then RETURN. The tube answers 4, then READY.
  • 3. Type 10 PRINT "HELLO" then RETURN, then 20 GOTO 10 then RETURN. Nothing shows: a line that starts with a number is stored in the program, it does not run right away.
  • 4. Type RUN then RETURN. HELLO scrolls forever. To stop: the BREAK key of the keyboard, or the cross at the top right, which goes back to the editor.

🧭 The three modes

  • The three buttons in the middle of the top bar change the view.
  • SCREEN: the machine alone, full size, with the joystick and FIRE. For playing, and for typing on the tube.
  • MIXED: the tube on top, the editor below. For writing a program and watching it run.
  • CODE: the editor alone, for long programs.
  • In SCREEN mode, the cross at the top right goes back to the editor.

🔝 The top bar, left to right

  • Gear: the quick settings (sounds, screen effects, iCloud…) and this guide.
  • Orange folder: Files and programs. The program gallery, New program, My programs, Cassette.
  • Blue book: the lexicon. Every word of BASIC in a list; touch a word to open its entry, with its syntax and an example to try.
  • SCREEN · MIXED · CODE: the three modes.
  • Tortoise, Hare, Bolt: the machine’s speed, AUTHENTIC, NORMAL or TURBO (see Settings).
  • Orange arrow: RESET. The machine restarts, the program stays.
  • Green triangle: runs the program. It turns into a red square to stop it.

🔘 The pills above the tube (SCREEN mode)

  • Camera: a photo of the tube, a video with sound, or the sound alone. While recording the pill turns red: touch it to stop and share.
  • Keyboard: raises or lowers the 1983 keyboard. A long press switches to the iOS keyboard, and back.
  • Joystick: shows or hides the joystick and FIRE.
  • Flank: shows or hides the five keys RESET, OPTION, SELECT, START, HELP.
  • Tortoise or hare: the speed.
  • Cross: back to the editor. If a program is running, it stops it too.
  • In landscape on iPhone, the pills sit in the margins on either side of the tube: the cross, the speed and the flank at the top left, the others at the top right, away from FIRE and the joystick.

⌨️ The 1983 keyboard

  • Everything you type is written on the tube. RETURN sends the line under the cursor to the machine.
  • You can move up onto a line already displayed (arrows: CTRL with -, =, + or *), fix it, and press RETURN again. That is how a program was corrected in 1983.
  • SHIFT gives the symbol printed at the top of the key. CTRL with a letter gives a graphics character. The machine writes in capitals: that is normal, it is its CAPS lock.
  • BREAK stops a running program. CTRL then 1 pauses its display and the POWER light reads PAUSE; CTRL then 1 again resumes. A program that asks a question (INPUT) raises the keyboard by itself.

📝 The editor (MIXED and CODE modes)

  • Every line starts with a number. +LINE adds the next number. RENUM renumbers the whole program cleanly. SEL.ALL selects the whole listing and DELETE removes what is selected: to empty the editor, touch one, then the other. When a keyboard is up, a keyboard button appears left of SEL.ALL: it lowers it.
  • The keyword bar, below the editor, holds every BASIC word of the machine, in alphabetical order: one touch writes the word. While you type, it slides to the words that start like what you are typing and shows them in orange: touching one finishes the word. A function is written with its open parenthesis, STICK(: type the argument and close the parenthesis. On iPhone, two tabs under the editor: CODE, the program, and MEMORY, the list of variables with their values.
  • What you type in the editor is immediately in the machine: there is only one program, the same in the editor and on the tube.
  • Green triangle: run. Red square: stop. Orange arrow (RESET): restarts the machine and keeps the program.
  • A wrong line is reported: right away if you type it on the tube, at RUN time if you wrote it in the editor.

⚠️ When something goes wrong

  • The tube prints ERROR- n AT LINE m: n is the error number, m the line where it happened. The lexicon (blue book) explains every error number.
  • A full-screen program (GRAPHICS with +16) must run in a loop: as soon as it ends, READY brings back the text screen. It was the same in 1983.
  • Tube text too small? The small magnifier at the corner of the tube, or a double tap on the tube, opens a magnifier. A bubble recalls the gestures: a finger moves it, a double tap closes it.
  • Sound went quiet after a call or a speaker change? It comes back with the next SOUND or the next click.

🎮 Playing

  • The joystick is on the left, FIRE on the right. In a program, STICK(0) reads the joystick, STRIG(0) reads FIRE, PADDLE(0) reads the finger sliding on the tube, in SCREEN mode.
  • The flank, at READY: START runs the program, SELECT opens the gallery, OPTION opens the preferences, HELP opens the lexicon, RESET restarts.
  • In a program, PEEK(53279) reads START, SELECT and OPTION; PEEK(732) reads HELP.

💻 On a Mac, or with a keyboard

  • On a Mac (Designed for iPad) and on an iPad with a keyboard, everything also works with the keyboard and the mouse. Without a keyboard, nothing changes.
  • While a program runs: the arrow keys are the joystick, diagonals included, and the space bar is FIRE. The drawn joystick still works; the held key wins.
  • At READY or during an INPUT: you type on the screen — letters, digits, Return, backspace, TAB, ESC — and the arrows move the cursor, like CTRL+arrow in 1983.
  • The flank (START, SELECT, OPTION, HELP, RESET), BREAK and the menus are clicked. Double-click on the tube: the magnifier. Copy and paste work in the editor.

📁 The gallery and my programs

  • Orange folder, Program gallery (or the SELECT key): your programs, then 80 examples in seven categories, BASICS, GRAPHICS, SOUND, WORKSHOP, GAMES, CLASSICS, DEMOS. The gallery opens on its sections: touch one to unfold it, and the search field finds a program by its title. On each line, RUN starts the program right away; touch its name to read what it does, and LOAD puts it in the editor. The star makes the program a favorite: it moves to the top of its category, and the FAVORITES section shows favorites only.
  • WORKSHOP: programs broken on purpose. Find the error and fix it.
  • Games: START or fire starts the game, OPTION pauses it, and the best score stays in memory (page 6) while the machine is on.
  • Orange folder, My programs: Save to storage keeps your program with a name, a category and tags. Manage programs finds, sorts (date, name, favorites first), renames, stars and deletes. Load from storage puts it back in the editor.
  • The editor is a draft. Save to storage always creates a new program, under the name you choose. If that name already exists, the app asks: Replace or Keep both.
  • A dot at the top of the editor marks a program that is not saved yet. If you load another one at that point, the app first asks Save the program?
  • When you quit the app, your program stays as it is: you find it again at the next launch.
  • Orange folder, My programs, at the bottom: import or export a .TXT file, share the program.
  • With iCloud (on by default, adjustable in PREFERENCES), your saved programs follow you on all your devices.
  • What each example does, and how each game is played: further on in this guide, one chapter per category.

📼 The cassette (CSAVE, CLOAD)

  • CSAVE, typed on the tube (or Orange folder, Cassette, Save to cassette): the machine beeps twice and puts a cassette in the box, under the program’s name.
  • CLOAD, typed on the tube (or Orange folder, Cassette, Load a cassette): the machine beeps once, the box opens, you touch a cassette and the program is loaded.
  • A cassette is a real sound file. The cassette box plays it, shares it, renames it, deletes it. You can also import a real vintage tape: a sound file digitized from a recorder, or a CAS archive file.
  • Cassettes are also visible in the Files app.
To a real machine: “Play to a real machine” sends the cassette’s sound through the headphone output (wired adapter) to a cassette adapter inserted in a period recorder, the machine waiting after CLOAD then RETURN. The signal follows the period format, but this has not yet been tried on an original machine. This page will be updated when it is.

⚙️ Settings (PREFERENCES, OPTION key at READY)

  • Language (French or English); tube keyboard (1983 or iOS); theme; tube font (1983 pixels, or smooth); interface sounds; editor font.
  • The theme colours the whole screen as long as a program does not set its own colours. As soon as it sets the background or the border (SETCOLOR 2 or SETCOLOR 4), the screen shows the true colours, the same in every theme.
  • CRT effects: scanlines, bloom, curvature. Controls: mirrored hands, stick size. Magnifier zoom. Cassette leader.
  • Speed: AUTHENTIC is the 1983 speed; NORMAL, four times faster; TURBO, as fast as possible, for demos that compute a lot.
  • iCloud: whether saved programs and a few settings sync with your account.
  • Help: the app guide, the lexicon, and About (version, what’s new, privacy policy, website, e-mail).

💡 Period tips

  • PRINT CHR$(125) clears the screen.
  • Dot abbreviations save time: PR. for PRINT, GR. for GRAPHICS, PL. for PLOT. LIST writes them out in full.
  • SOUND 0,0,0,0 silences a voice. TRAP n sends the program to line n when an error occurs, instead of stopping.
  • After about ten minutes with no input, the colours change by themselves and dim: that is the 1983 screen saver. A key, the joystick or FIRE brings them back.

📚 The gallery programs, one by one

What each example does, and how each game is played.

BASICS

The first words of BASIC, one program each.

  • HELLO WORLD: prints HELLO WORLD eight times with a FOR loop.
  • COUNT 1-10: counts from 1 to 10.
  • IF/THEN: counts to 20 and prints BIG once the number is over 10.
  • FIBONACCI: the sequence where each number is the sum of the two before it, up to 100.
  • GUESS NUMBER: the machine picks a number from 1 to 10 and you have to find it.
  • INPUT NAME: asks your name, greets you and counts its letters.
  • DATA LIST: reads a list of fruits and quantities kept in a DATA line.
  • MENU (ON): a three-choice menu, with ON … GOTO.
  • ASCII ART: prints the alphabet from codes 65 to 90, with CHR$.
  • TEXT SLICER: cuts a text into pieces and replaces one.
  • DEG / RAD / FRE: the same sine in degrees then in radians, and the free memory.
  • JOYSTICK TEST: prints UP, DOWN, LEFT, RIGHT or FIRE as you use the joystick.
  • KEY TEST (GET): shows the code of each key you press. Q quits.
  • GRID (2D): fills a 4 by 4 array, then prints it.
  • MATH FUNCTIONS: EXP, LOG, CLOG and ATN tried on four numbers.
  • NUMBERS AND TEXT: turns a number into text and back (STR$, VAL), and spots the numbers that read the same backwards.
  • STEP BY STEP: stops with STOP, goes on when you type CONT, and leaves a loop with POP.
  • SELF PORTRAIT: the program lists its own lines, then shows PUT, STATUS and CLR.

GRAPHICS

Short drawings, to discover the graphics modes.

  • DRAW BOX: draws a rectangle with four lines.
  • COLOR BARS: twelve bars in the three colours of GRAPHICS 7.
  • CIRCLE PI: a dotted circle, worked out with the number pi.
  • CHAOS FRACTAL: 2000 random points that end up drawing a triangle made of triangles.
  • RAYS: 36 rays from the centre of the screen.
  • RANDOM RECT: random rectangles, forever.
  • RAINBOW (SETCOLOR): lines that go through the sixteen hues, one after the other.
  • STORM: lightning in every direction, in colour, and thunder.
  • GR.7 + FILL (XIO): a rectangle filled in one go with XIO 18.
  • MODES 3 TO 8: the same drawing in graphics modes 3 to 8, from the biggest dot to the finest.
  • JOYSTICK SKETCH: a sketch pad. The joystick draws, FIRE changes colour, START clears everything.

SOUND

For listening: sound effects, then music on the four voices of SOUND.

  • SOUND DEMO: one voice sliding from high to low.
  • STEAM ENGINE: the puffing of a steam engine, forever.
  • ROBOT BLIPS: twenty random beeps, like a talking robot.
  • SIREN: a siren going down and up again, forever.
  • HELICOPTER: the beat of helicopter blades.
  • 4-VOICE CHORD: a C major chord on all four voices, fading away.
  • BASS + MELODY: eight melody notes over a held bass, played three times.
  • TWINKLE TWINKLE: the nursery tune, note by note, on a single voice.
  • PACHELBEL’S CANON: three violins come in one after the other over eight bass notes.
  • COMPOSER: pick the key, mode, style and tempo, or 0 for chance. The machine composes a piece that sounds right and plays it. At the end, four keys on the machine keyboard: replay, new, settings or quit.

WORKSHOP

Ten programs broken on purpose. Run, read the error, fix the line, run again.

  • THE LOST NEXT: should print 1 to 5. Look at the NEXT.
  • THE FORGOTTEN STRING: should say hello. A text needs a DIM.
  • THE CRAZY DIVISION: should divide 100 by N. N was never given a value.
  • THE JUMP TO NOWHERE: should count 1, 2, 3. The GOTO aims at a line that does not exist.
  • THE GARBLED LINE: should print twice 21. Line 80 has to be typed again.
  • THE CLOSED CHANNEL: should read a key. GET wants a channel opened with OPEN.
  • OUT OF DATA: should read four prices. Count the DATA.
  • RETURN WITHOUT GOSUB: should greet then stop. Nothing stops the program before the subroutine.
  • THE STRING TOO SHORT: should spell BASIC. The DIM is too small.
  • OFF THE CANVAS: should draw a line. In GRAPHICS 7, X stops at 159.

GAMES

In these nine games, START or FIRE starts the game, OPTION pauses it, and the best score is kept.

  • SUPER JUMP: run to the right and jump over the obstacles with FIRE or the joystick up. Landing on the enemy crushes it and gives time back. Reach the end before time runs out.
  • METEOR STORM: dodge the falling meteors, joystick left and right.
  • MOON LANDER: land gently on the bright platform. Joystick up for thrust, left and right to drift. Fuel is limited.
  • SPACE DEFENDERS: joystick left and right, FIRE shoots. Two rows drop bombs, three shields give cover, a saucer sometimes flies by. Ammunition is limited, and running out costs one of your three lives.
  • PADDLE BALL: send the ball back, joystick left and right. One level every ten returns, and the ball speeds up.
  • CANYON RUN: go down the canyon without touching the walls, joystick left and right.
  • UFO HUNT: the joystick moves the sight, FIRE shoots. You have sixty seconds to hit saucers and the mothership, without shooting the white plane. Five targets make a level and give ten seconds back.
  • BASKET: catch the apples in the basket, with the joystick or by sliding a finger on the tube. A level every five apples, and they fall faster. Three apples missed and it is over.
  • ALIEN CARGO: joystick left and right, FIRE shoots at the cargo ship or its bombs. Dodge the bombs and, from level 2, the ray that freezes you. Three lives, and one more every 1000 points.

CLASSICS

Long programs, like the ones people typed in from magazines.

  • SNAKE: on the title screen, START plays, SELECT sets the speed, OPTION turns the walls on or off. The joystick steers the snake: eat the apples without touching yourself.
  • BRICK WALL: send the ball back to break the 32 bricks, joystick left and right. Three lives. The ball starts right away.
  • SIMON SAYS: watch the sequence, then repeat it with the joystick: up, down, left, right. It grows at each level, up to ten.
  • HANGMAN: find the word letter by letter, on the keyboard. Seven mistakes and you lose.
  • MAZE: the machine digs a maze as you watch. Then, with the joystick, find the exit at the bottom right. Your time is counted.
  • TIC-TAC-TOE: you play X against the machine. Type the number of the square, from 1 to 9.
  • FOUR IN LINE: two players, or one against the machine on three levels. On the menu, type 1 or 2 on the machine keyboard; then the joystick and FIRE, or keys 1 to 7, drop a piece. Line up four.
  • MENTAL ARITHMETIC: ten questions against the clock, on three levels. The best score of each level is kept.

DEMOS

To watch and listen to. The ones that compute a lot run better in TURBO.

  • CUBE 3D: a spinning wireframe cube. Smoother in TURBO.
  • TUNNEL: nested squares with cycling colours: it feels like moving through a tunnel.
  • SUNSET: the sun over the sea in sixteen shades (GRAPHICS 9), with a shimmering reflection.
  • BACH PRELUDE: Bach’s prelude in C major (1722), in three voices.
  • FIREWORKS: rockets that climb and burst in colour, with the sound.
  • FRACTAL TREE: a tree that grows, branch after branch.
  • KALEIDOSCOPE: a drawing repeated by eight mirrors, with cycling colours.
  • MOIRE: fine lines that cross and make waves appear.
  • STAINED GLASS: filled triangles, placed at random like the pieces of a stained glass window.
  • SPIROGRAPH: rosettes like the ones from the toy with toothed wheels.
  • SOMBRERO 3D: a surface in relief, shaped like a hat. It takes a long time to compute: NORMAL or TURBO.
  • PIANO: play on the keyboard: A (or Q), S, D, F, G, H, J, K, or 1 to 8, for C, D, E, F, G, A, B, C.
  • STOPWATCH: a stopwatch with a hand: the second hand turns, the minutes add up.
  • THE GAME OF LIFE: cells are born and die by three rules. Pick a start, from 1 to 4, and watch: green lives, yellow is born, red dies.

🧭 Design choices

BASIC 1983 is an original interpreter, with no affiliation with any manufacturer. The language follows a specification drawn from period documentation and checked by an automated test suite; known differences are documented. The gallery examples were written for the app.

🔒 No account, no sign-up, no network access: the app runs offline, with no advertising, no in-app purchases and no analytics. iCloud, optional, only copies your programs and a few settings into your own account.

📱 Requirements

  • iOS 18.6 or later
  • iPhone and iPad, portrait and landscape
  • No Internet connection required
  • French and English, switchable in the Preferences
  • No permission requested: no microphone, no photos, no location

✉️ Support

A question, a remark, a suggestion? Write to us through the contact form.