Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 25f686617b0fe19d7ecd24770d0de5369ac28265 / . / Bliss OS / extras / index.html
blob: aea4db039d4882365847762aa4209a0d860948bb [file] [log] [blame]
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1
2
3
4
5<!doctype html>
6<html lang="en" class="no-js">
7 <head>
8
9 <meta charset="utf-8">
10 <meta name="viewport" content="width=device-width,initial-scale=1">
11 <meta http-equiv="x-ua-compatible" content="ie=edge">
12
13
14
15
16 <meta name="lang:clipboard.copy" content="Copy to clipboard">
17
18 <meta name="lang:clipboard.copied" content="Copied to clipboard">
19
20 <meta name="lang:search.language" content="en">
21
22 <meta name="lang:search.pipeline.stopwords" content="True">
23
24 <meta name="lang:search.pipeline.trimmer" content="True">
25
26 <meta name="lang:search.result.none" content="No matching documents">
27
28 <meta name="lang:search.result.one" content="1 matching document">
29
30 <meta name="lang:search.result.other" content="# matching documents">
31
32 <meta name="lang:search.tokenizer" content="[\s\-]+">
33
34 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.3">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]36
37
38
39 <title>Extras - Team Bliss</title>
40
41
42
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]43 <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.css">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]44
45
46
47
48 <script src="../../assets/javascripts/modernizr.74668098.js"></script>
49
50
51
52 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono&display=fallback">
54 <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
55
56
57 <link rel="stylesheet" href="../../assets/fonts/material-icons.css">
58
59
60
61
62
63
64 </head>
65
66 <body dir="ltr">
67
68 <svg class="md-svg">
69 <defs>
70
71
72 </defs>
73 </svg>
74 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
75 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
76 <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
77
78 <a href="#extras" tabindex="1" class="md-skip">
79 Skip to content
80 </a>
81
82
83 <header class="md-header" data-md-component="header">
84 <nav class="md-header-nav md-grid">
85 <div class="md-flex">
86 <div class="md-flex__cell md-flex__cell--shrink">
87 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo">
88
89 <i class="md-icon"></i>
90
91 </a>
92 </div>
93 <div class="md-flex__cell md-flex__cell--shrink">
94 <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
95 </div>
96 <div class="md-flex__cell md-flex__cell--stretch">
97 <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
98
99 <span class="md-header-nav__topic">
100 Team Bliss
101 </span>
102 <span class="md-header-nav__topic">
103
104 Extras
105
106 </span>
107
108 </div>
109 </div>
110 <div class="md-flex__cell md-flex__cell--shrink">
111
112 <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
113
114<div class="md-search" data-md-component="search" role="dialog">
115 <label class="md-search__overlay" for="__search"></label>
116 <div class="md-search__inner" role="search">
117 <form class="md-search__form" name="search">
118 <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
119 <label class="md-icon md-search__icon" for="__search"></label>
120 <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
121 &#xE5CD;
122 </button>
123 </form>
124 <div class="md-search__output">
125 <div class="md-search__scrollwrap" data-md-scrollfix>
126 <div class="md-search-result" data-md-component="result">
127 <div class="md-search-result__meta">
128 Type to start searching
129 </div>
130 <ol class="md-search-result__list"></ol>
131 </div>
132 </div>
133 </div>
134 </div>
135</div>
136
137 </div>
138
139 </div>
140 </nav>
141</header>
142
143 <div class="md-container">
144
145
146
147
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]148 <main class="md-main" role="main">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]149 <div class="md-main__inner md-grid" data-md-component="container">
150
151
152 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
153 <div class="md-sidebar__scrollwrap">
154 <div class="md-sidebar__inner">
155 <nav class="md-nav md-nav--primary" data-md-level="0">
156 <label class="md-nav__title md-nav__title--site" for="__drawer">
157 <a href="../.." title="Team Bliss" class="md-nav__button md-logo">
158
159 <i class="md-icon"></i>
160
161 </a>
162 Team Bliss
163 </label>
164
165 <ul class="md-nav__list" data-md-scrollfix>
166
167
168
169
170
171
172 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]173 <a href="../.." title="Home" class="md-nav__link">
174 Home
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]175 </a>
176 </li>
177
178
179
180
181
182
183
184
185
186 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
187
188 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
189
190 <label class="md-nav__link" for="nav-2">
191 Bliss OS
192 </label>
193 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
194 <label class="md-nav__title" for="nav-2">
195 Bliss OS
196 </label>
197 <ul class="md-nav__list" data-md-scrollfix>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../" title="Index" class="md-nav__link">
207 Index
208 </a>
209 </li>
210
211
212
213
214
215
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]216
217 <li class="md-nav__item">
218 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
219 Build Guide
220 </a>
221 </li>
222
223
224
225
226
227
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]228
229
230
231 <li class="md-nav__item md-nav__item--active">
232
233 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
234
235
236
237
238 <label class="md-nav__link md-nav__link--active" for="__toc">
239 Extras
240 </label>
241
242 <a href="./" title="Extras" class="md-nav__link md-nav__link--active">
243 Extras
244 </a>
245
246
247<nav class="md-nav md-nav--secondary">
248
249
250
251
252
253 <label class="md-nav__title" for="__toc">Table of contents</label>
254 <ul class="md-nav__list" data-md-scrollfix>
255
256 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]257 <a href="#setting-up-taskbar-on-bliss-os-pie" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]258 Setting up Taskbar on Bliss OS (Pie)
259 </a>
260
261</li>
262
263 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]264 <a href="#setting-up-gapps" class="md-nav__link">
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]265 Setting up GApps
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]266 </a>
267
268</li>
269
270 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]271 <a href="#watching-netflix-foss-gms-builds" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]272 Watching Netflix - FOSS &amp; GMS Builds
273 </a>
274
275</li>
276
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]277 <li class="md-nav__item">
278 <a href="#setting-up-magisk" class="md-nav__link">
279 Setting up Magisk
280 </a>
281
282</li>
283
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]284
285
286
287
288 </ul>
289
290</nav>
291
292 </li>
293
294
295
296
297
298
299
300 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]301 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
302 Installation Guide (Misc)
303 </a>
304 </li>
305
306
307
308
309
310
311
312 <li class="md-nav__item">
313 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
314 Installation Guide (Surface devices)
315 </a>
316 </li>
317
318
319
320
321
322
323
324 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]325 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
326 Installation Guide
327 </a>
328 </li>
329
330
331
332
333
334
335
336 <li class="md-nav__item">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]337 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
338 Taking bug reports
339 </a>
340 </li>
341
342
343
344
345
346
347
348 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]349 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
350 Troubleshooting
351 </a>
352 </li>
353
354
355 </ul>
356 </nav>
357 </li>
358
359
360
361
362
363
364
365 <li class="md-nav__item md-nav__item--nested">
366
367 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
368
369 <label class="md-nav__link" for="nav-3">
370 BlissRoms
371 </label>
372 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
373 <label class="md-nav__title" for="nav-3">
374 BlissRoms
375 </label>
376 <ul class="md-nav__list" data-md-scrollfix>
377
378
379
380
381
382
383
384 <li class="md-nav__item">
385 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
386 Index
387 </a>
388 </li>
389
390
391
392
393
394
395
396 <li class="md-nav__item">
397 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
398 Build Guide
399 </a>
400 </li>
401
402
403
404
405
406
407
408 <li class="md-nav__item">
409 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
410 Build Tips
411 </a>
412 </li>
413
414
415 </ul>
416 </nav>
417 </li>
418
419
420
421
422
423
424
425 <li class="md-nav__item md-nav__item--nested">
426
427 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
428
429 <label class="md-nav__link" for="nav-4">
430 Common
431 </label>
432 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
433 <label class="md-nav__title" for="nav-4">
434 Common
435 </label>
436 <ul class="md-nav__list" data-md-scrollfix>
437
438
439
440
441
442
443
444 <li class="md-nav__item">
445 <a href="../../common/" title="Index" class="md-nav__link">
446 Index
447 </a>
448 </li>
449
450
451
452
453
454
455
456 <li class="md-nav__item">
457 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
458 Git Started
459 </a>
460 </li>
461
462
463
464
465
466
467
468 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]469 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
470 Maintaining proper authorship
471 </a>
472 </li>
473
474
475
476
477
478
479
480 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]481 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
482 Using `dippy-bird`
483 </a>
484 </li>
485
486
487 </ul>
488 </nav>
489 </li>
490
491
492
493
494
495
496
497 <li class="md-nav__item md-nav__item--nested">
498
499 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
500
501 <label class="md-nav__link" for="nav-5">
502 Infrastructure
503 </label>
504 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
505 <label class="md-nav__title" for="nav-5">
506 Infrastructure
507 </label>
508 <ul class="md-nav__list" data-md-scrollfix>
509
510
511
512
513
514
515
516 <li class="md-nav__item">
517 <a href="../../infrastructure/" title="Index" class="md-nav__link">
518 Index
519 </a>
520 </li>
521
522
523 </ul>
524 </nav>
525 </li>
526
527
528 </ul>
529</nav>
530 </div>
531 </div>
532 </div>
533
534
535 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
536 <div class="md-sidebar__scrollwrap">
537 <div class="md-sidebar__inner">
538
539<nav class="md-nav md-nav--secondary">
540
541
542
543
544
545 <label class="md-nav__title" for="__toc">Table of contents</label>
546 <ul class="md-nav__list" data-md-scrollfix>
547
548 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]549 <a href="#setting-up-taskbar-on-bliss-os-pie" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]550 Setting up Taskbar on Bliss OS (Pie)
551 </a>
552
553</li>
554
555 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]556 <a href="#setting-up-gapps" class="md-nav__link">
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]557 Setting up GApps
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]558 </a>
559
560</li>
561
562 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]563 <a href="#watching-netflix-foss-gms-builds" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]564 Watching Netflix - FOSS &amp; GMS Builds
565 </a>
566
567</li>
568
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]569 <li class="md-nav__item">
570 <a href="#setting-up-magisk" class="md-nav__link">
571 Setting up Magisk
572 </a>
573
574</li>
575
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]576
577
578
579
580 </ul>
581
582</nav>
583 </div>
584 </div>
585 </div>
586
587
588 <div class="md-content">
589 <article class="md-content__inner md-typeset">
590
591
592
593 <h1 id="extras">Extras</h1>
594<h2 id="setting-up-taskbar-on-bliss-os-pie">Setting up Taskbar on Bliss OS (Pie)</h2>
595<p>If you would like to use Taskbar as your default launcher, you will need to first go into "Settings &gt; Blissify &gt; Gestures", and enable something like Carbon Gestures (we recommend setting up three-finger swipes: Right for Back, Down for Home, &amp; Up for Recents), then you can go to "Blissify &gt; Buttons" and switch the navigation mode to SmartBar, then go back and disable the navigation bar from there by switching off "Allow Navigation Bar on the top". At this point, you need to switch to your home screen, so swipe up with your gesture, or tap the Windows key (or Windows-Esc). Then launch Taskbar, enable it, set to launch on boot. We recommend disabling hiding. Enable a couple other settings in the "Freeform" and "Advanced" screens as required. Setting it up this way will prevent any crashes from happening on initial launch. And it allows you to also use the Quickstep launcher as the main background. </p>
596<p>Here's a video tutorial on how to do it properly:</p>
597<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/htFC8poBEPY" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
598
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]599<h2 id="setting-up-gapps">Setting up GApps</h2>
600<div class="admonition warning">
601<p class="admonition-title">Warning</p>
602<p>Recent builds of Bliss OS have Gapps included. If your <code>.iso</code> file name includes "GMS", it has GApps built in and you shouldn't follow the guide below. If your file name includes "FOSS", it does not have GApps built in.</p>
603</div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]604<p><a href="https://forum.xda-developers.com/showpost.php?p=79289406&amp;postcount=632">See this thread from @wrwolf2!</a></p>
605<h2 id="watching-netflix-foss-gms-builds">Watching Netflix - FOSS &amp; GMS Builds</h2>
606<p>Netflix considers our rooted OS as an "incompatible" device, according to their support articles. <a href="https://www.apkmirror.com/apk/netflix-inc/netflix/netflix-4-16-1-build-15145-release/">This version of Netflix seems to work great</a>, as long as you don't update it. If it prompts you, click on "Cancel".</p>
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]607<h2 id="setting-up-magisk">Setting up Magisk</h2>
608<ol>
609<li>Extract the latest Bliss OS <code>.iso</code>, and grab those files:<ul>
610<li><code>initrd.img</code></li>
611<li><code>ramdisk.img</code></li>
612<li><code>kernel</code></li>
613</ul>
614</li>
615<li>Run:
616 <code>mkbootimg --kernel kernel --ramdisk ramdisk.img --second initrd.img --output boot.img</code></li>
617<li>Copy the boot image to Bliss OS.</li>
618<li>Use Magisk Manager to patch the boot image. Select Install &gt; Select and Patch File, and then select the <code>boot.img</code> you created earlier. The patcher should produce the file <code>magisk_patched.img</code>.</li>
619<li>
620<p>We need to remove the current superuser binary. Run within Bliss OS in a terminal emulator</p>
621<p><code>su</code></p>
622<p><code>cd /system/xbin &amp;&amp; mv su su.bak</code></p>
623<p><code>exit</code></p>
624</li>
625<li>
626<p>Copy the patched <code>magisk_patched.img</code> file back to your computer.</p>
627</li>
628<li>
629<p>Unpack the image:</p>
630<p><code>unpackimg magisk_patched.img</code></p>
631</li>
632<li>
633<p>Rename the following files:</p>
634<ul>
635<li><code>magisk_patched.img-zImage</code> to <code>kernel</code></li>
636<li><code>magisk_patched.img-second</code> to <code>initrd.img</code></li>
637<li><code>magisk_patched.img-ramdisk.cpio.gz</code> to <code>ramdisk.img</code></li>
638</ul>
639</li>
640<li>
641<p>Replace the files back to the original Bliss OS <code>.iso</code>.</p>
642</li>
643<li>Boot to Bliss, and you should have a successful Magisk installation!</li>
644</ol>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]645
646
647
648
649
650
651
652
653
654 </article>
655 </div>
656 </div>
657 </main>
658
659
660<footer class="md-footer">
661
662 <div class="md-footer-nav">
663 <nav class="md-footer-nav__inner md-grid">
664
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]665 <a href="../build-guide/" title="Build Guide" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]666 <div class="md-flex__cell md-flex__cell--shrink">
667 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
668 </div>
669 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
670 <span class="md-flex__ellipsis">
671 <span class="md-footer-nav__direction">
672 Previous
673 </span>
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]674 Build Guide
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]675 </span>
676 </div>
677 </a>
678
679
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]680 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]681 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
682 <span class="md-flex__ellipsis">
683 <span class="md-footer-nav__direction">
684 Next
685 </span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]686 Installation Guide (Misc)
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]687 </span>
688 </div>
689 <div class="md-flex__cell md-flex__cell--shrink">
690 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
691 </div>
692 </a>
693
694 </nav>
695 </div>
696
697 <div class="md-footer-meta md-typeset">
698 <div class="md-footer-meta__inner md-grid">
699 <div class="md-footer-copyright">
700
701 powered by
702 <a href="https://www.mkdocs.org">MkDocs</a>
703 and
704 <a href="https://squidfunk.github.io/mkdocs-material/">
705 Material for MkDocs</a>
706 </div>
707
708 </div>
709 </div>
710</footer>
711
712 </div>
713
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]714 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]715
716 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
717
718
719 </body>
720</html>