# SOME DESCRIPTIVE TITLE. # Copyright (C) Micah Lee, et al. # This file is distributed under the same license as the OnionShare package. # FIRST AUTHOR , 2020. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: OnionShare 2.3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-02-09 10:21+1100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.14.0\n" #: ../../source/advanced.rst:2 msgid "Advanced Usage" msgstr "" #: ../../source/advanced.rst:7 msgid "Save Tabs" msgstr "" #: ../../source/advanced.rst:9 msgid "" "Closing OnionShare tabs you host destroys them, preventing reuse. " "Persistently hosted websites are available on the same address even if " "the computer they are shared from is rebooted." msgstr "" #: ../../source/advanced.rst:12 msgid "" "Make any tab persistent by checking the \"Always open this tab when " "OnionShare is started\" box before starting your server." msgstr "" #: ../../source/advanced.rst:16 msgid "" "When opening OnionShare, your saved tabs from the prior session will " "start opened. Each service then can be started manually, and will be " "available on the same OnionShare address and be protected by the same " "private key." msgstr "" #: ../../source/advanced.rst:19 msgid "" "If you save a tab, a copy of its onion service secret key is stored on " "your computer." msgstr "" #: ../../source/advanced.rst:24 msgid "Turn Off Private Key" msgstr "" #: ../../source/advanced.rst:26 msgid "" "By default, all OnionShare services are protected with a private key, " "which Tor calls \"client authentication\"." msgstr "" #: ../../source/advanced.rst:28 msgid "" "The Tor Browser will ask you to enter your private key when you load an " "OnionShare service. If you want to allow the public to use your service, " "it's better to disable the private key altogether." msgstr "" #: ../../source/advanced.rst:31 msgid "" "To turn off the private key for any tab, check the \"This is a public " "OnionShare service (disables private key)\" box before starting the " "server. Then the server will be public and a private key is not needed to" " load it in the Tor Browser." msgstr "" #: ../../source/advanced.rst:37 msgid "Custom Titles" msgstr "" #: ../../source/advanced.rst:39 msgid "" "When people load OnionShare services in the Tor Browser they see the " "default title for each type of service. For example, the default title " "for chat services is \"OnionShare Chat\"." msgstr "" #: ../../source/advanced.rst:42 msgid "" "If you edit the \"Custom title\" setting before starting a server you can" " change it." msgstr "" #: ../../source/advanced.rst:45 msgid "Scheduled Times" msgstr "" #: ../../source/advanced.rst:47 msgid "" "OnionShare supports scheduling exactly when a service should start and " "stop. Before starting a server, click \"Show advanced settings\" in its " "tab and then check the boxes next to either \"Start onion service at " "scheduled time\", \"Stop onion service at scheduled time\", or both, and " "set the respective desired dates and times." msgstr "" #: ../../source/advanced.rst:51 msgid "" "Services scheduled to start in the future display a countdown timer when " "the \"Start sharing\" button is clicked. Services scheduled to stop in " "the future display a countdown timer when started." msgstr "" #: ../../source/advanced.rst:54 msgid "" "**Scheduling an OnionShare service to automatically start can be used as " "a dead man's switch**. This means your service is made public at a given " "time in the future if you are not there to prevent it. If nothing happens" " to you, you can cancel the service before it's scheduled to start." msgstr "" #: ../../source/advanced.rst:60 msgid "" "**Scheduling an OnionShare service to automatically stop limits its " "exposure**. If you want to share secret info or something that will be " "outdated, you can do so for selected limited time." msgstr "" #: ../../source/advanced.rst:68 msgid "Command-line Interface" msgstr "" #: ../../source/advanced.rst:70 msgid "" "In addition to its graphical interface, OnionShare has a command-line " "interface." msgstr "" #: ../../source/advanced.rst:73 msgid "Installing the CLI version" msgstr "" #: ../../source/advanced.rst:75 msgid "" "If you have installed the Snap, macOS or Windows package, you already " "have the CLI version installed." msgstr "" #: ../../source/advanced.rst:77 msgid "" "Alternatively, you can install just the command-line version of " "OnionShare using ``pip3``::" msgstr "" #: ../../source/advanced.rst:81 msgid "" "Note that you will also need the ``tor`` package installed. In macOS, " "install it with: ``brew install tor``" msgstr "" #: ../../source/advanced.rst:83 msgid "Then run it like this::" msgstr "" #: ../../source/advanced.rst:87 msgid "" "Info about installing it on different operating systems can be found in " "the `CLI README file " "`_ " "in the Git repository." msgstr "" #: ../../source/advanced.rst:90 msgid "Running the CLI from Snap" msgstr "" #: ../../source/advanced.rst:92 msgid "" "If you installed OnionShare using the Snap package, you can run " "``onionshare.cli`` to access the command-line interface version." msgstr "" #: ../../source/advanced.rst:95 msgid "Running the CLI from macOS" msgstr "" #: ../../source/advanced.rst:97 msgid "" "From Terminal, you can run ``/Applications/OnionShare.app/Contents/MacOS" "/onionshare-cli --help``" msgstr "" #: ../../source/advanced.rst:100 msgid "Running the CLI from Windows" msgstr "" #: ../../source/advanced.rst:102 msgid "" "In the Windows installation, the executable ``onionshare-cli.exe`` is " "available." msgstr "" #: ../../source/advanced.rst:105 msgid "Usage" msgstr "" #: ../../source/advanced.rst:107 msgid "Browse the command-line documentation by running ``onionshare --help``::" msgstr "" #: ../../source/advanced.rst:170 msgid "Running the CLI as a systemd unit file" msgstr "" #: ../../source/advanced.rst:172 msgid "" "It is possible to automatically start OnionShare from the CLI using a " "systemd unit file." msgstr "" #: ../../source/advanced.rst:174 msgid "" "You may find this particularly useful if you are operating in " "'persistent' mode, and want to start the same onion service every time " "your machine starts." msgstr "" #: ../../source/advanced.rst:176 msgid "To do this, you need to prepare some OnionShare json config first." msgstr "" #: ../../source/advanced.rst:178 msgid "" "Here is the main OnionShare config. In this example, it's stored in " "``/home/user/.config/onionshare/onionshare.json``. You may need to adjust" " some of the settings, but if you already have OnionShare installed, it " "probably looks much like this already::" msgstr "" #: ../../source/advanced.rst:207 msgid "" "Notice the 'persistent_tabs' section. We will now create a file at " "``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, " "that looks like this::" msgstr "" #: ../../source/advanced.rst:247 msgid "" "**Don't actually use this private key, service_id or client_auth keys! " "They are shown only as an example. Never share the private_key with " "anyone.**" msgstr "" #: ../../source/advanced.rst:249 msgid "" "The easiest way to generate the onion address and private key is to first" " create a 'pinned' OnionShare tab in the desktop app and started the " "share for the first time. This will then have saved the persistent " "settings to your ``.config/onionshare/persistent/`` folder with a random " "name. You can unpin that tab once you've generated it the first time. Or," " you can leave it where it is, and use that persistent file in your " "systemd unit file below." msgstr "" #: ../../source/advanced.rst:251 msgid "" "Now you can create a systemd unit file in ``/etc/systemd/system" "/onionshare-cli.service``. Be sure to adjust the User and Group to your " "own user/group, as well as changes to any paths to the onionshare-cli " "binary or the paths to your JSON configs and shares." msgstr "" #: ../../source/advanced.rst:253 msgid "The systemd unit file should look like this::" msgstr "" #: ../../source/advanced.rst:268 msgid "" "Note that although ``/home/user/my-shared-file.txt`` was defined in the " "``filenames`` section of the ``my-persistent-onion.json`` file, it's " "still necessary to specify it as the argument to the onionshare-cli " "command." msgstr "" #: ../../source/advanced.rst:270 msgid "" "Be sure to run ``sudo systemctl daemon-reload`` after creating the unit " "file." msgstr "" #: ../../source/advanced.rst:272 msgid "" "Now you can run ``sudo systemctl start onionshare-cli.service``. If you " "have ``journalctl`` installed, you can run ``sudo journalctl -f -t " "onionshare-cli``, and you should see some output of your service " "starting::" msgstr "" #: ../../source/advanced.rst:282 msgid "" "If you don't want your users to use a Private Key, set ``public`` to be " "``true`` in the ``general`` settings of the my-persistent-onion.json " "file." msgstr "" #: ../../source/advanced.rst:286 msgid "Keyboard Shortcuts" msgstr "" #: ../../source/advanced.rst:288 msgid "" "The OnionShare desktop application contains some keyboard shortcuts, for " "convenience and accessibility::" msgstr "" #: ../../source/advanced.rst:293 msgid "And from the main mode chooser screen::" msgstr "" #: ../../source/advanced.rst:303 msgid "Migrating your OnionShare data to another computer" msgstr "" #: ../../source/advanced.rst:305 msgid "" "You may want to migrate your OnionShare data when switching to another " "computer. This is especially true if you had a 'persistent' onion address" " and you want to preserve it." msgstr "" #: ../../source/advanced.rst:307 msgid "" "OnionShare stores all such data in a specific folder. Copy the relevant " "folder for your operating system below, to your new computer:" msgstr "" #: ../../source/advanced.rst:309 msgid "Linux: ``~/.config/onionshare``" msgstr "" #: ../../source/advanced.rst:310 msgid "macOS: ``~/Library/Application Support/OnionShare``" msgstr "" #: ../../source/advanced.rst:311 msgid "Windows: ``%APPDATA%\\OnionShare``" msgstr "" #~ msgid "" #~ "Services scheduled to start in the " #~ "future display a countdown timer when" #~ " when the \"Start sharing\" button is" #~ " clicked. Services scheduled to stop " #~ "in the future display a countdown " #~ "timer when started." #~ msgstr "" #~ msgid "" #~ "You can install just the command-" #~ "line version of OnionShare using " #~ "``pip3``::" #~ msgstr "" #~ msgid "" #~ "If you installed OnionShare using the" #~ " Snap package, you can also just " #~ "run ``onionshare.cli`` to access the " #~ "command-line interface version." #~ msgstr "" #~ msgid "" #~ "Linux: ``~/.config/onionshare`` macOS: " #~ "``~/Library/Application Support/OnionShare`` Windows: " #~ "``%APPDATA%\\OnionShare``" #~ msgstr "" #~ msgid "" #~ "__Don't actually use this private key," #~ " service_id or client_auth keys! They " #~ "are shown only as an example. " #~ "Never share the private_key with " #~ "anyone.__" #~ msgstr ""