overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8814 Commits
13 Branches
36 MiB
 
 
Tree: d4f8d0918a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'd4f8d0918a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge...

362 lines
13 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  12. "Report-Msgid-Bugs-To: \n"

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  16. "Language: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

  21. "Content-Transfer-Encoding: 8bit\n"

  22. "Generated-By: Babel 2.16.0\n"

  23. 

  24. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:1

  25. msgid "Setting up Messenger bridging via Mautrix Meta (optional)"

  26. msgstr ""

  27. 

  28. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:3

  29. msgid ""

  30. "The playbook can install and configure the [mautrix-"

  31. "meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "

  32. "you."

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:5

  36. msgid ""

  37. "Since this bridge component can bridge to both "

  38. "[Messenger](https://messenger.com/) and "

  39. "[Instagram](https://instagram.com/) and you may wish to do both at the "

  40. "same time, the playbook makes it available via 2 different Ansible roles "

  41. "(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"

  42. "instagram`). The latter is a reconfigured copy of the first one (created "

  43. "by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"

  44. "instagram.sh`)."

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:7

  48. msgid ""

  49. "This documentation page only deals with the bridge's ability to bridge to"

  50. " Facebook Messenger. For bridging to Instagram, see [Setting up Instagram"

  51. " bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"

  52. "instagram.md)."

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:9

  56. msgid "Prerequisites"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:11

  60. msgid "Migrating from the old mautrix-facebook bridge"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:13

  64. msgid ""

  65. "If you've been using the [mautrix-facebook](./configuring-playbook-"

  66. "bridge-mautrix-facebook.md) bridge, it's possible to migrate the database"

  67. " using [instructions from the bridge "

  68. "documentation](https://docs.mau.fi/bridges/go/meta/facebook-"

  69. "migration.html) (advanced)."

  70. msgstr ""

  71. 

  72. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:15

  73. msgid ""

  74. "Then you may wish to get rid of the Facebook bridge. To do so, send a "

  75. "`clean-rooms` command to the management room with the old bridge bot "

  76. "(`@facebookbot:example.com`). It gives you a list of portals and groups "

  77. "of portals you may purge. Proceed with sending commands like `clean "

  78. "recommended`, etc."

  79. msgstr ""

  80. 

  81. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:17

  82. msgid ""

  83. "Then, consider disabling the old bridge in your configuration, so it "

  84. "won't recreate the portals when you receive new messages."

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:19

  88. msgid ""

  89. "**Note**: the user ID of the new bridge bot is "

  90. "`@messengerbot:example.com`, not `@facebookbot:example.com`. After "

  91. "disabling the old bridge, its bot user will stop responding to a command."

  92. msgstr ""

  93. 

  94. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:21

  95. msgid "Enable Appservice Double Puppet (optional)"

  96. msgstr ""

  97. 

  98. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:23

  99. msgid ""

  100. "If you want to set up [Double "

  101. "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "

  102. "(hint: you most likely do) for this bridge automatically, you need to "

  103. "have enabled [Appservice Double Puppet](configuring-playbook-appservice-"

  104. "double-puppet.md) service for this playbook."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:25

  108. msgid ""

  109. "For details about configuring Double Puppeting for this bridge, see the "

  110. "section below: [Set up Double Puppeting](#-set-up-double-puppeting)"

  111. msgstr ""

  112. 

  113. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:27

  114. msgid "Adjusting the playbook configuration"

  115. msgstr ""

  116. 

  117. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:29

  118. msgid ""

  119. "To enable the bridge, add the following configuration to your "

  120. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:35

  124. msgid ""

  125. "Before proceeding to [re-running the playbook](./installing.md), you may "

  126. "wish to adjust the configuration further. See below."

  127. msgstr ""

  128. 

  129. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:37

  130. msgid "Bridge mode"

  131. msgstr ""

  132. 

  133. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:39

  134. msgid ""

  135. "As mentioned above, the [mautrix-meta](https://github.com/mautrix/meta) "

  136. "bridge supports multiple modes of operation."

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:41

  140. msgid "The bridge can pull your Messenger messages via 3 different methods:"

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:43

  144. msgid "(`facebook`) Facebook via `facebook.com`"

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:44

  148. msgid ""

  149. "(`facebook-tor`) Facebook via "

  150. "`facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion` "

  151. "([Tor](https://www.torproject.org/)) - does not currently proxy media "

  152. "downloads"

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:45

  156. msgid ""

  157. "(default) (`messenger`) Messenger via `messenger.com` - usable even "

  158. "without a Facebook account"

  159. msgstr ""

  160. 

  161. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:47

  162. msgid ""

  163. "You may switch the mode via the `matrix_mautrix_meta_messenger_meta_mode`"

  164. " variable. The playbook defaults to the `messenger` mode, because it's "

  165. "most universal (every Facebook user has a Messenger account, but the "

  166. "opposite is not true)."

  167. msgstr ""

  168. 

  169. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:49

  170. msgid ""

  171. "Note that switching the mode (especially between `facebook*` and "

  172. "`messenger`) will intentionally make the bridge use another database "

  173. "(`matrix_mautrix_meta_facebook` or `matrix_mautrix_meta_messenger`) to "

  174. "isolate the 2 instances. Switching between Tor and non-Tor may be "

  175. "possible without dataloss, but your mileage may vary. Before switching to"

  176. " a new mode, you may wish to de-configure the old one (send `help` to the"

  177. " bridge bot and unbridge your portals, etc.)."

  178. msgstr ""

  179. 

  180. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:51

  181. msgid "Bridge permissions"

  182. msgstr ""

  183. 

  184. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:53

  185. msgid "By default, any user on your homeserver will be able to use the bridge."

  186. msgstr ""

  187. 

  188. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:55

  189. msgid "Different levels of permission can be granted to users:"

  190. msgstr ""

  191. 

  192. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:57

  193. msgid "`relay` - Allowed to be relayed through the bridge, no access to commands"

  194. msgstr ""

  195. 

  196. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:58

  197. msgid "`user` - Use the bridge with puppeting"

  198. msgstr ""

  199. 

  200. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:59

  201. msgid "`admin` - Use and administer the bridge"

  202. msgstr ""

  203. 

  204. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:61

  205. msgid ""

  206. "The permissions are following the sequence: nothing < `relay` < `user` < "

  207. "`admin`."

  208. msgstr ""

  209. 

  210. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:63

  211. msgid ""

  212. "The default permissions are set via "

  213. "`matrix_mautrix_meta_messenger_bridge_permissions_default` and are "

  214. "somewhat like this:"

  215. msgstr ""

  216. 

  217. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:72

  218. msgid ""

  219. "If you don't define the `matrix_admin` in your configuration (e.g. "

  220. "`matrix_admin: @alice:example.com`), then there's no admin by default."

  221. msgstr ""

  222. 

  223. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:74

  224. msgid ""

  225. "You may redefine "

  226. "`matrix_mautrix_meta_messenger_bridge_permissions_default` any way you "

  227. "see fit, or add extra permissions using "

  228. "`matrix_mautrix_meta_messenger_bridge_permissions_custom` like this:"

  229. msgstr ""

  230. 

  231. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:81

  232. msgid ""

  233. "You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"

  234. "messenger/templates/config.yaml.j2` to find more information on the "

  235. "permissions settings and other options you would like to configure."

  236. msgstr ""

  237. 

  238. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:83

  239. msgid "Installing"

  240. msgstr ""

  241. 

  242. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:85

  243. msgid ""

  244. "After configuring the playbook, run it with [playbook tags](playbook-"

  245. "tags.md) as below:"

  246. msgstr ""

  247. 

  248. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:92

  249. msgid "**Notes**:"

  250. msgstr ""

  251. 

  252. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:94

  253. msgid ""

  254. "The `ensure-matrix-users-created` playbook tag makes the playbook "

  255. "automatically create the bot's user account."

  256. msgstr ""

  257. 

  258. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:96

  259. msgid ""

  260. "The shortcut commands with the [`just` program](just.md) are also "

  261. "available: `just install-all` or `just setup-all`"

  262. msgstr ""

  263. 

  264. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:98

  265. msgid ""

  266. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  267. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  268. "runtime) than `just setup-all`) when its components remain unchanged. If "

  269. "you adjust your `vars.yml` to remove other components, you'd need to run "

  270. "`just setup-all`, or these components will still remain installed."

  271. msgstr ""

  272. 

  273. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:100

  274. msgid "Usage"

  275. msgstr ""

  276. 

  277. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:102

  278. msgid ""

  279. "To use the bridge, you need to start a chat with "

  280. "`@messengerbot:example.com` (where `example.com` is your base domain, not"

  281. " the `matrix.` domain). Note that the user ID of the bridge's bot is not "

  282. "`@facebookbot:example.com`."

  283. msgstr ""

  284. 

  285. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:104

  286. msgid ""

  287. "You then need to send a `login` command and follow the bridge bot's "

  288. "instructions."

  289. msgstr ""

  290. 

  291. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:106

  292. msgid ""

  293. "Given that the bot is configured in `messenger` [bridge mode](#bridge-"

  294. "mode) by default, you will need to log in to "

  295. "[messenger.com](https://messenger.com/) (not `facebook.com`!) and obtain "

  296. "the cookies from there as per [the bridge's authentication "

  297. "instructions](https://docs.mau.fi/bridges/go/meta/authentication.html)."

  298. msgstr ""

  299. 

  300. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:108

  301. msgid "💡 Set up Double Puppeting"

  302. msgstr ""

  303. 

  304. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:110

  305. msgid ""

  306. "After successfully enabling bridging, you may wish to set up [Double "

  307. "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "

  308. "(hint: you most likely do)."

  309. msgstr ""

  310. 

  311. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:112

  312. msgid "To set it up, you have 2 ways of going about it."

  313. msgstr ""

  314. 

  315. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:114

  316. msgid "Method 1: automatically, by enabling Appservice Double Puppet"

  317. msgstr ""

  318. 

  319. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:116

  320. msgid ""

  321. "The bridge automatically performs Double Puppeting if [Appservice Double "

  322. "Puppet](configuring-playbook-appservice-double-puppet.md) service is "

  323. "configured and enabled on the server for this playbook."

  324. msgstr ""

  325. 

  326. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:118

  327. msgid ""

  328. "This is the recommended way of setting up Double Puppeting, as it's "

  329. "easier to accomplish, works for all your users automatically, and has "

  330. "less of a chance of breaking in the future."

  331. msgstr ""

  332. 

  333. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:120

  334. msgid "Method 2: manually, by asking each user to provide a working access token"

  335. msgstr ""

  336. 

  337. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:122

  338. msgid ""

  339. "When using this method, **each user** that wishes to enable Double "

  340. "Puppeting needs to follow the following steps:"

  341. msgstr ""

  342. 

  343. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124

  344. msgid ""

  345. "retrieve a Matrix access token for yourself. Refer to the documentation "

  346. "on [how to do that](obtaining-access-tokens.md)."

  347. msgstr ""

  348. 

  349. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126

  350. msgid ""

  351. "send the access token to the bot. Example: `login-matrix "

  352. "MATRIX_ACCESS_TOKEN_HERE`"

  353. msgstr ""

  354. 

  355. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:128

  356. msgid ""

  357. "make sure you don't log out the session for which you obtained an access "

  358. "token some time in the future, as that would break the Double Puppeting "

  359. "feature"

  360. msgstr ""