1. Dein Buch ist ein Ordner, den du ohne uns öffnen kannst.

    Mit der Desktop-App, die bald erscheint, ist ein lokales Shiro-Projekt ein gewöhnlicher Ordner mit Markdown-Dateien auf deinem Computer. Es funktioniert offline und ohne Konto, und jeder Texteditor kann es öffnen. Cloud-Projekte funktionieren anders, wie unten erklärt, und sie sind nicht Ende-zu-Ende-verschlüsselt.

  2. Anderswo bearbeitet

    Öffne sie in Obsidian. Shiro merkt es.

    Ändere eine Szene in einer anderen App, während sie in Shiro ruht, und Shiro lädt sie neu und sagt es dir. Keine der beiden Fassungen geht je verloren.

  3. Beide Seiten

    Mitten im Satz hält das Speichern inne

    Ändert sich die Datei, während du tippst, hält Shiro an und fragt, was bleiben soll. Die Fassung, die du nicht behältst, landet bei den Schnappschüssen.

  4. Auf deiner Festplatte

    Sicherungen, an die du nicht denken musstest

    Schnappschüsse und ZIP-Sicherungen landen automatisch auf deiner eigenen Festplatte. Dazu verschlüsselte Kopien mit einer Passphrase, die nur du kennst.

  5. In die Cloud

    Das solltest du wissen, bevor du umziehst

    Nach In die Cloud verschieben ist die Cloud-Kopie das Buch. Der Ordner bleibt als Sicherung, und spätere Änderungen an diesen Dateien gehen nirgendwohin.

  6. Und zurück

    Wieder ein Ordner, wann immer du willst

    Als Ordner herunterladen macht aus einem Cloud-Buch wieder Markdown, wo immer du willst, und entfernt dann die Cloud-Kopie.

Deine Dateien sind für alle gebaut, die schon einmal ein Buch verloren haben

Ein kurzer Brief von Shiro, für alle, die sich noch an die Datei erinnern, die sich nicht öffnen ließ.

Liebe Schreibende,

du hast schon einmal Arbeit verloren. Ein Programm, das nicht mehr verkauft wurde, ein Format, das nichts mehr liest, eine Firma, die übernommen wurde und dann still verschwand. Das Buch gehörte dir, die Datei irgendwie nicht. Wir wollen, dass das nie wieder passiert, dir nicht und niemandem.

Deshalb ist ein lokales Shiro-Projekt ein gewöhnlicher Ordner mit Markdown-Dateien. Eine Datei pro Szene, ein Kopf mit Zusammenfassung und Status, dann jedes Wort, das du geschrieben hast. Schnappschüsse, Kommentare und die Aufzeichnung der Urheberschaft liegen daneben in .shiro/. Wenn Shiro morgen verschwände, bliebe dir ein ordentlicher Ordner und ein paar seltsame Zeichen.

Die Cloud ist da, wenn du andere Menschen ins Buch holen willst. Kenn den Tausch, bevor du umziehst: Der Server kann ein Cloud-Projekt lesen, und der Weg zurück ist ein Knopf, Als Ordner herunterladen.

Wir hoffen, dass du nichts davon je ausprobieren musst.

Deine, in reinem Text,

Shiro

So behältst du dein Buch als Dateien

Vier Schritte, von einem neuen Projekt zu einem Ordner, den du ohne uns öffnen kannst.

  1. Wähle Auf diesem Computer. In der Desktop-App, die bald erscheint. Kein Konto nötig.

  2. Wähle den Ordner. Wo du willst: deine Dokumente, ein synchronisiertes Laufwerk, ein Git-Repository.

  3. Schreib wie gewohnt. Jede Szene wird beim Schreiben als Markdown-Datei gespeichert.

  4. Öffne es überall. Jeder Texteditor liest es. Shiro merkt, wenn du es dort änderst.

Alles, was du unterwegs brauchst

Was im Ordner steckt und was die Cloud ändert, je eine Kachel.

Leg es in Git ab

Szenen sind einfache Textdateien, die Diffs sind also lesbar. Du siehst genau, was du letzten März mit dem Ende gemacht hast, und machst es mit einem Werkzeug rückgängig, das nichts mit uns zu tun hat.

Seltsame Zeichen, mehr nicht

Öffne eine Szene woanders, und du findest [[links]], %%notes%% und CriticMarkup. Gewöhnliche Zeichen, leicht zu entfernen.

Reihenfolge nach Namen

Die Zahlen am Anfang der Namen bestimmen die Reihenfolge. Was sie nicht ausdrücken können, steht in .shiro/order.json.

Ein Papierkorb, den du öffnen kannst

Was du löschst, landet in .trash/, unter seinem ursprünglichen Pfad. Hol es mit jedem Dateimanager wieder heraus.

Auch für Sachbücher

Sachbücher und Memoiren haben Research/ statt World/. Derselbe Ordner, ein anderes Regal.

Die ehrliche Seite der Cloud

Cloud-Projekte werden verschlüsselt übertragen, sind aber nicht Ende-zu-Ende-verschlüsselt: Der Server liest sie für Verlauf, Webhooks und Agenten. Wenn das für dieses Buch ein Problem ist, behalte es lokal.

Jeder Editor geht

Obsidian, VS Code, der Texteditor auf dem alten Laptop. Speichere dort, und Shiro führt zusammen oder fragt nach. Keine Fassung geht je verloren.

Und noch viel mehr

  • Standardmäßig offline: Die Desktop-App kontaktiert keinen Server, bis du dich anmeldest.
  • Kein Konto: Lokale Projekte brauchen keins, auf Mac, Windows oder Linux.
  • Getestet, nicht versprochen: Ein Browsertest schlägt fehl, wenn der Client deinen Rechner verlässt.
  • ZIP-Backups: ganze Projekte, auf deiner eigenen Platte, jeden Tag.
  • Dreiwege-Zusammenführung: Wenn sich beide Seiten geändert haben, treffen sich die Änderungen, und die unterlegene wird zum Schnappschuss.
  • Als Ordner herunterladen: ein Cloud-Buch zurück in einen Markdown-Ordner, wann immer du willst.
  • Cloud, wenn du sie willst: Schreib in der Web-App mit anderen, Zeichen für Zeichen zusammengeführt.
  • Die Urheberschaft bleibt ehrlich: Außerhalb von Shiro geänderter Text zählt als nicht erfasst.

Häufige Fragen

Muss ich in Markdown schreiben?

Nein. Du schreibst in einem normalen Editor mit Kursivschrift, Fußnoten und einem Slash-Menü. Shiro speichert das Ergebnis als Markdown, und der Syntax begegnest du nur, wenn du die Datei woanders öffnest.

Funktioniert Shiro ohne Internetverbindung?

Ja, mit der Desktop-App, die bald erscheint. Auf Mac, Windows und Linux braucht sie für lokale Projekte weder eine Verbindung noch ein Konto. Sie kontaktiert keinen Shiro-Server, bis du dich anmeldest.

Kann ich mein Buch in Git verwalten?

Ja. Szenen sind Textdateien, die Diffs sind also lesbar, und du siehst genau, was du letzten März mit dem Ende gemacht hast.

Sind Cloud-Projekte verschlüsselt?

Nicht Ende zu Ende. Sie werden über verschlüsselte Verbindungen übertragen, aber Shiros Server kann sie lesen, weil Verlauf, Webhooks und Agenten das brauchen. Wenn das für dieses Buch ein Problem ist, behalte das Projekt lokal.

Dein Buch. Deine Platte. Deine Entscheidung.