nfrapradohttps://nfraprado.net/pt-br/2025-12-29T00:00:00-03:00Retrospectiva de 2025 com camisetas2025-12-29T00:00:00-03:002025-12-29T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-12-29:/pt-br/post/retrospectiva-de-2025-com-camisetas.html<p>Esse ano eu comprei mais camisetas do que qualquer outro ano. Em grande parte porque eu decidi ir em todos os shows que eu pudesse.</p> <p>Com o ano se encerrando, esse me pareceu um bom momento pra rever as camisetas que eu colecionei ao longo do ano e ver a …</p><p>Esse ano eu comprei mais camisetas do que qualquer outro ano. Em grande parte porque eu decidi ir em todos os shows que eu pudesse.</p> <p>Com o ano se encerrando, esse me pareceu um bom momento pra rever as camisetas que eu colecionei ao longo do ano e ver a história que elas contam. Então aqui vai minha retrospectiva de 2025 por meio de camisetas:</p> <img alt="{image}/shirts-collage.jpg" src="/images/2025-shirts/shirts-collage.jpg" /> <p>Seguindo a ordem da esquerda superior até a direita inferior:</p> <ul class="simple"> <li>Linha 1, Coluna 1: Março. Fui no show do Three Days Grace e Disturbed. Three Days Grace era minha banda favorita na adolescência, e no dia do show eu descobri que o Adam Gontier, o cantor, que tinha saído da banda muitos anos antes, tinha acabado de voltar pra banda. Esse show foi um sonho realizado pro meu adolescente interior.</li> <li>1-2: Março. Eu vi uma pessoa vestindo essa camiseta numa foto de um grupo de voluntariado que eu participava e na hora perguntei onde eu podia comprar uma. Inclusive eu comprei duas extras pra dar de presente pra amigos. Ela é de longe minha camiseta mais popular, já recebeu elogios em muitas ocasiões e uma vez até alguém pediu pra tirar foto dela. Segue o link da loja caso também tenha se interessado: <a class="reference external" href="https://mtpfriends.bigcartel.com/product/what-s-more-punk-adult-t-shirt">https://mtpfriends.bigcartel.com/product/what-s-more-punk-adult-t-shirt</a></li> <li>1-3: Abril. Fui num evento social no bairro e vi uma banda local que era bem boa chamada Lolux.</li> <li>1-4: Maio. Fui no show do Bloc Party no Forest Hills Stadium. Eu saí dele um pouco decepcionado com a qualidade do som mas foi divertido mesmo assim. Fora que graças a esse show eu descobri Forest Hills, que é um bairro bem caricato difícil de acreditar que faz parte da cidade de Nova Iorque (NYC).</li> <li>2-1: Junho. <a class="reference external" href="https://www.wonderville.nyc/">Wonderville</a> é simplesmente meu lugar favorito em NYC. Eles definem o lugar como &quot;O lar para jogos arcade feitos independentemente no Brooklyn&quot;. Ele tem uma estética bem estilo cyberpunk, todos os jogos podem ser jogados de graça, e eles frequentemente fazem eventos únicos, desde <em>livecoding</em> (música gerada por código ao vivo), até <em>game jams</em> e torneios de beyblade. Essa camiseta foi feita pra comemorar o aniversário de 6 anos do lugar. Acabei não indo na festa, mas peguei a camiseta algumas semanas depois quando levei um amigo, que estava visitando NYC, lá para apresentar o lugar, algo que já se tornou uma tradição pra mim (esse é o terceiro amigo visitante que levo lá).</li> <li>2-2: Junho. Fui no show do Godspeed You! Black Emperor em Norwalk, CT. A viagem de 1 hora de trem até uma cidade pequena contribuiu pra experiência. O show foi muito único, o palco era muito escuro, projeções de filme em preto e branco selecionadas a dedo eram passadas na parede de trás, e o som alternava entre silêncios solitários e barulhos opressivos de guitarras e violinos distorcidos. Escute <a class="reference external" href="https://www.youtube.com/watch?v=cQcE4_7-X78">Sleep</a> para ter uma ideia do som, mas ver ao vivo foi outra coisa.</li> <li>2-3: Julho. Fui em um show ao vivo do Welcome to Night Vale no Brooklyn. Eu escutava esse podcast durante a faculdade, então foi bem nostálgico ouvir de novo, e ver ao vivo, com interações com a plateia, tornou ele ainda mais divertido.</li> <li>2-4: Julho. Fui no show do Creed no Jones Beach Theater. A casa de show era linda, ao ar livre e de frente para o mar, e foi ótimo ouvir Creed ao vivo. Esse foi o primeiro show que eu fui com a minha mãe e o fato de termos ido de trem e ficado em um hotel até o dia seguinte tornou esse passeio uma pequena viagem de férias.</li> <li>3-1: Julho. Eu amo post-rock, e shows pequenos, então apesar de só ter escutado um álbum do We Lost the Sea há muitos anos atrás, eu não podia perder a oportunidade de vê-los de perto por apenas 25$. Foi incrível, esses shows pequenos são os melhores.</li> <li>3-2: Agosto. Em contraste, pouco depois eu paguei 171$, os tickets de show mais caros da minha vida, para ver Linkin Park no Prudential Center em Newark. A vista era boa, mas meu assento era tão alto que eu me senti desconectado do show. Além disso, apesar de essa camiseta ser, pela etiqueta, do mesmo tamanho que eu sempre compro, ela é gigantesca.</li> <li>3-3: Agosto. Fui de novo no Forest Hills Stadium, dessa vez para ver Black Keys com um amigo. Começou a chover bastante (irônico, dado o texto da camiseta) pouco depois que eles começaram a tocar, mas por sorte parou de chover a tempo para o show prosseguir, apesar de ter sido um pouco mais curto.</li> <li>3-4: Setembro. Fui ver Breaking Benjamin e Three Days Grace (de novo!). Apesar de ser minha banda favorita na adolescência, ver TDG essa segunda vez foi muito pior e me fez pensar que não vale a pena ver a mesma banda duas vezes. Eles tocaram praticamente as mesmas músicas, e dessa vez tinham um telão atrás mostrando visuais bem toscos claramente gerados por IA. Ainda bem que Breaking Benjamin foi fantástico e fez o show valer a pena.</li> <li>4-1: Outubro. Na noite anterior de eu ir viajar, eu vi Anamanaguchi no Brooklyn Steel. Eu só conhecia duas músicas deles, e eles só tocaram uma delas, mas eu gostei bastante do álbum novo deles que conheci no show. Eles também tocaram Hopes and Dreams do Undertale para homenagear o aniversário do criador do jogo que era naquele dia, e como eu sou muito fã da música do Undertale, isso tornou esse show ainda mais único e inesquecível.</li> <li>4-2: Outubro. A maior parte de outubro eu passei viajando de carro com um amigo pela Califórnia como mencionei no <a class="reference external" href="/pt-br/post/musica-do-mes-christopher-cross-sailing.html">artigo "Música do Mês: Christopher Cross - Sailing"</a>. Foram muitas maravilhas naturais, mas minha preferida foram as sequoias que vimos no Parque Nacional das Sequoias. Por isso aproveitei pra passar na lojinha de presentes onde comprei uma camiseta (e pins!) pra ter uma recordação desse lugar incrível.</li> <li>4-3: Novembro. E para finalizar o ano, vi Of Monsters and Men no Brooklyn Paramount com a minha namorada. O pit estava bem cheio então era um pouco difícil de ver às vezes, mas o lugar era lindo e nos divertimos. Essa camiseta é de manga longa, a primeira que eu compro em mais de dez anos, e é tão linda. Acho que é minha camiseta favorita do ano.</li> </ul> Música do Mês: Andy Williams - Do You Hear What I Hear?2025-12-01T00:00:00-03:002025-12-01T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-12-01:/pt-br/post/musica-do-mes-andy-williams-do-you-hear-what-i-hear.html<p>Um pouco atrasado para novembro, mas antes tarde do que nunca!</p> <p>Com a chegada de novembro, e do clima natalino, eu coloquei para escutar uma <a class="reference external" href="https://www.youtube.com/watch?v=g8UmqvOqB1A&amp;list=PLBN3i8jrg4Wze3v_KZRPFmnQrTw5jia61&amp;index=1">playlist de músicas antigas de natal no YouTube</a>.</p> <p>Muitas das músicas eu nunca tinha ouvido antes. Algumas das minhas favoritas foram <a class="reference external" href="https://www.youtube.com/watch?v=lvVfIi0mQx4">Carol of the Bells …</a></p><p>Um pouco atrasado para novembro, mas antes tarde do que nunca!</p> <p>Com a chegada de novembro, e do clima natalino, eu coloquei para escutar uma <a class="reference external" href="https://www.youtube.com/watch?v=g8UmqvOqB1A&amp;list=PLBN3i8jrg4Wze3v_KZRPFmnQrTw5jia61&amp;index=1">playlist de músicas antigas de natal no YouTube</a>.</p> <p>Muitas das músicas eu nunca tinha ouvido antes. Algumas das minhas favoritas foram <a class="reference external" href="https://www.youtube.com/watch?v=lvVfIi0mQx4">Carol of the Bells</a>, <a class="reference external" href="https://www.youtube.com/watch?v=oQ_2K6Jk8vs">The First Noel</a> e <a class="reference external" href="https://www.youtube.com/watch?v=4EvZOXEoJ84">Darlene Love - Christmas (Baby Please Come Home)</a>.</p> <p>Mas a minha favorita de todas é com certeza &quot;Do You Hear What I Hear?&quot;, especificamente a versão cantada por Andy Williams, então essa é minha música do mês:</p> <p><a class="reference external" href="https://www.youtube.com/watch?v=ksIZijfEuoY">Andy Williams - Do You Hear What I Hear?</a></p> Música do Mês: Christopher Cross - Sailing2025-10-28T00:00:00-03:002025-10-28T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-10-28:/pt-br/post/musica-do-mes-christopher-cross-sailing.html<p>Esse mês eu e um amigo pegamos um carro e dirigimos pela Califórnia por duas semanas. Nós navegamos no Lake Tahoe, andamos pelas dunas de areia no Death Valley, e trilhamos entre as montanhas no Yosemite Valley. Nós vimos as árvores mais velhas do mundo no Ancient Bristlecone Pine Forest …</p><p>Esse mês eu e um amigo pegamos um carro e dirigimos pela Califórnia por duas semanas. Nós navegamos no Lake Tahoe, andamos pelas dunas de areia no Death Valley, e trilhamos entre as montanhas no Yosemite Valley. Nós vimos as árvores mais velhas do mundo no Ancient Bristlecone Pine Forest, e também as maiores, no Sequoia National Park, em meio a uma neblina misteriosa.</p> <p>Nós ouvimos muitas músicas ao longo da viagem, mas houve uma delas que aparentemente conquistou meu amigo imediatamente, já que ele colocou ela de novo muitas vezes depois. É de fato uma linda música, e vai para sempre carregar a memória dessa incrível viagem. É a minha escolha para esse mês:</p> <p><a class="reference external" href="https://www.youtube.com/watch?v=MEO6gYCFbr0">Christopher Cross - Sailing</a></p> <img alt="{image}/general-sherman.jpg" src="/images/song-202510/general-sherman.jpg" /> Música do Mês: Moin - Lift You2025-09-30T00:00:00-03:002025-09-30T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-09-30:/pt-br/post/musica-do-mes-moin-lift-you.html<p>A minha escolha de música do mês dessa vez é uma música que tocou no <a class="reference external" href="https://www.spectacletheater.com/">Spectacle Theater</a> antes do filme começar (o filme era <a class="reference external" href="https://www.spectacletheater.com/i-know-youre-out-there/#miragemen">Mirage Men (2013)</a>, a propósito). A letra é bem poética, e a instrumentação tem um quê de surrealismo e mistério. É uma ótima música por si …</p><p>A minha escolha de música do mês dessa vez é uma música que tocou no <a class="reference external" href="https://www.spectacletheater.com/">Spectacle Theater</a> antes do filme começar (o filme era <a class="reference external" href="https://www.spectacletheater.com/i-know-youre-out-there/#miragemen">Mirage Men (2013)</a>, a propósito). A letra é bem poética, e a instrumentação tem um quê de surrealismo e mistério. É uma ótima música por si só, mas ela foi elevada por ter sido tocada em um dos meus lugares favoritos em NYC e combinar perfeitamente com a sensação do momento.</p> <p>Confira:</p> <p><a class="reference external" href="https://m-o-i-n.bandcamp.com/track/lift-you-feat-sophia-al-maria">Moin - Lift You</a></p> Atualização da coleção de pins (128 pins em três imagens e uma tabela)2025-09-04T00:00:00-03:002025-09-04T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-09-04:/pt-br/post/atualizacao-da-colecao-de-pins-128-pins-em-tres-imagens-e-uma-tabela.html<p>Já fazem quase dois anos desde que eu publiquei o <a class="reference external" href="/pt-br/post/colecionando-pins.html">artigo "Colecionando pins"</a>! Já está na hora de compartilhar uma atualização.</p> <p>De lá para cá eu decidi ser mais organizado e comecei uma planilha para catalogar todos os detalhes da minha coleção de pins. A principal coisa que eu queria …</p><p>Já fazem quase dois anos desde que eu publiquei o <a class="reference external" href="/pt-br/post/colecionando-pins.html">artigo "Colecionando pins"</a>! Já está na hora de compartilhar uma atualização.</p> <p>De lá para cá eu decidi ser mais organizado e comecei uma planilha para catalogar todos os detalhes da minha coleção de pins. A principal coisa que eu queria ter é um histórico claro da coleção: quando, onde e como cada pin foi adicionado à coleção. E depois de gastar bastante tempo preenchendo as lacunas, hoje eu posso finalmente compartilhá-lo!</p> <p>Então aqui está, minha coleção de pins atual, composta por 128 pins ocupando duas caixinhas e meia, resumida em três imagens e uma tabela:</p> <img alt="{image}/display1.jpg" src="/images/pins-spreadsheet/display1.jpg" /> <img alt="{image}/display2.jpg" src="/images/pins-spreadsheet/display2.jpg" /> <img alt="{image}/display3.jpg" src="/images/pins-spreadsheet/display3.jpg" /> <table border="1" class="docutils"> <colgroup> <col width="20%" /> <col width="20%" /> <col width="20%" /> <col width="20%" /> <col width="20%" /> </colgroup> <thead valign="bottom"> <tr><th class="head">No.</th> <th class="head">Nome</th> <th class="head">Quando</th> <th class="head">Onde</th> <th class="head">Como</th> </tr> </thead> <tbody valign="top"> <tr><td>1</td> <td><a class="reference external" href="https://www.etsy.com/listing/587004849/poring-poporing-slime-monter-fanart-hard">Poring — Ragnarok Online</a></td> <td>2022-12-01</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>2</td> <td><a class="reference external" href="https://www.etsy.com/listing/587004849/poring-poporing-slime-monter-fanart-hard">Poporing — Ragnarok Online</a></td> <td>2022-12-01</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>3</td> <td><a class="reference external" href="https://www.etsy.com/listing/742804941/deviruchi-gg-ragnarok-online-enamel-pin">/Gg Emote — Ragnarok Online</a></td> <td>2022-12-16</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>4</td> <td><a class="reference external" href="https://www.etsy.com/listing/742804941/deviruchi-gg-ragnarok-online-enamel-pin">Deviruchi — Ragnarok Online</a></td> <td>2022-12-16</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>5</td> <td><a class="reference external" href="https://www.etsy.com/listing/842366471/?variation0=1473891219">Fairy Bottle — Zelda</a></td> <td>2022-12-16</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>6</td> <td><a class="reference external" href="https://www.etsy.com/listing/729815460/eeveelution-hard-enamel-pins-complete?variation0=1222773687">Eevee — Pokémon</a></td> <td>2022-12-21</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>7</td> <td>L — Death Note</td> <td>2023-02-08</td> <td>Loja geek em Antuérpia, Bélgica</td> <td>Compra</td> </tr> <tr><td>8</td> <td>Phantom Of The Opera</td> <td>2023-02-13</td> <td>Show do Fantasma da Ópera no Majestic Theatre em NYC</td> <td>Compra</td> </tr> <tr><td>9</td> <td><a class="reference external" href="https://store.moma.org/products/artist-enamel-pin-van-gogh">Van Gogh's The Starry Night</a></td> <td>2023-03-11</td> <td>MoMA em NYC</td> <td>Compra</td> </tr> <tr><td>10</td> <td><a class="reference external" href="https://www.fangamer.com/collections/katamari-damacy/products/king-of-all-cosmos-pin-spinning">King — Katamari Damacy</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>11</td> <td><a class="reference external" href="https://www.fangamer.com/collections/katamari-damacy/products/katamari-damacy-the-prince-katamari-spinning-pin">Prince &amp; Katamari — Katamari Damacy</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>12</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-annoying-dog-lapel-pin">Annoying Dog — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>13</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-1">Flowey — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>14</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-1">Sans — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>15</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-1">Frisk — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>16</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-2">Papyrus — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>17</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-1">Toriel — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>18</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-2">Undyne — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>19</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-mercy-or-fight-enamel-pin-set">Mercy Button — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>20</td> <td><a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-mercy-or-fight-enamel-pin-set">Fight Button — Undertale</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>21</td> <td><a class="reference external" href="https://www.fangamer.com/collections/stardew-valley/products/pinverse-junimos-pin-pack">Junimo Package — Stardew Valley</a></td> <td>2023-03-23</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>22</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/449">? Block — Super Mario Bros.</a></td> <td>2023-03-23</td> <td>Estande de mercadorias da PAX na PAX East 23</td> <td>Compra</td> </tr> <tr><td>23</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/446">Mario — Super Mario Bros.</a></td> <td>2023-03-23</td> <td>Estande de mercadorias da PAX na PAX East 23</td> <td>Compra</td> </tr> <tr><td>24</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/1362">East 2023 Logo</a></td> <td>2023-03-23</td> <td>Estande de mercadorias da PAX na PAX East 23</td> <td>Compra</td> </tr> <tr><td>25</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/1365">PAX East VHS</a></td> <td>2023-03-23</td> <td>Estande de mercadorias da PAX na PAX East 23</td> <td>Compra</td> </tr> <tr><td>26</td> <td><a class="reference external" href="https://www.neomerch.com/item.php?id=1294">Babaa — Neopets</a></td> <td>2023-03-24</td> <td>Estande da Geekify na PAX East 23</td> <td>Compra</td> </tr> <tr><td>27</td> <td><a class="reference external" href="https://www.neomerch.com/item.php?id=2651">Wraith Paintbrush — Neopets</a></td> <td>2023-03-24</td> <td>Estande da Geekify na PAX East 23</td> <td>Compra</td> </tr> <tr><td>28</td> <td><a class="reference external" href="https://www.neomerch.com/item.php?id=1287">Strawberry Fields Forever Paintbrush — Neopets</a></td> <td>2023-03-24</td> <td>Estande da Geekify na PAX East 23</td> <td>Compra</td> </tr> <tr><td>29</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/279">Raz — Psychonauts</a></td> <td>2023-03-24..26</td> <td>Salão de trocas da PAX East 23</td> <td>Presente</td> </tr> <tr><td>30</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/1106">Kerbal Space Program</a></td> <td>2023-03-24..26</td> <td>Salão de trocas da PAX East 23</td> <td>Presente</td> </tr> <tr><td>31</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/271">Atlas And P-Body — Portal 2</a></td> <td>2023-03-24..26</td> <td>Salão de trocas da PAX East 23</td> <td>Troca</td> </tr> <tr><td>32</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/276">Diamond Ore Block — Minecraft</a></td> <td>2023-03-24..26</td> <td>Salão de trocas da PAX East 23</td> <td>Troca</td> </tr> <tr><td>33</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/703">Mae — Night In The Woods</a></td> <td>2023-03-24..26</td> <td>Estande da Finji na PAX East 23</td> <td>Compra</td> </tr> <tr><td>34</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/921">Green Flame — Acquisitions Inc.</a></td> <td>2023-03-24..26</td> <td>Estande da Acquisitions Incorporated na PAX East 23</td> <td>Compra</td> </tr> <tr><td>35</td> <td><a class="reference external" href="https://www.fangamer.com/products/raz-psychonauts-pin-spinning">Psychokinetic Raz — Psychonauts 2</a></td> <td>2023-03-24..26</td> <td>Estande da Fangamer na PAX East 23</td> <td>Compra</td> </tr> <tr><td>36</td> <td>Goose — Kickstarter</td> <td>2023-03-24..26</td> <td>Estande do Kickstarter na PAX East 23</td> <td>Recompensa</td> </tr> <tr><td>37</td> <td><a class="reference external" href="https://pinnydb.com/pinDetail/1360">PAX Gold Mixtape</a></td> <td>2023-03-24..26</td> <td>Roleta no estande do Pinny Arcade na PAX East 23</td> <td>Recompensa</td> </tr> <tr><td>38</td> <td>Portuguese Tile</td> <td>2023-05-06..07</td> <td>Portugal (Porto?)</td> <td>Compra</td> </tr> <tr><td>39</td> <td>Software Freedom Conservancy's Logo</td> <td>2023-05-08..11</td> <td>Encontro da Collabora em Portugal</td> <td>Presente (do Padovan)</td> </tr> <tr><td>40</td> <td>Collabora's Logo</td> <td>2023-05-08..11</td> <td>Encontro da Collabora em Portugal</td> <td>Presente (do Guy)</td> </tr> <tr><td>41</td> <td><a class="reference external" href="https://www.fangamer.com/products/dwarf-fortress-pin-finely-crafted">+Finely-Crafted Dwarven Pin+ — Dwarf Fortress</a></td> <td>2023-05-20</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>42</td> <td>Fairly Oddparents</td> <td>2023-06-06</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>43</td> <td>Loto</td> <td>2023-11-09..11</td> <td>Casa em NYC</td> <td>Presente (do Tony)</td> </tr> <tr><td>44</td> <td>Ecuador</td> <td>2023-11-09..11</td> <td>Casa em NYC</td> <td>Presente (do Tony)</td> </tr> <tr><td>45</td> <td>Los Andes</td> <td>2023-11-09..11</td> <td>Casa em NYC</td> <td>Presente (do Tony)</td> </tr> <tr><td>46</td> <td>Canada Wilderness</td> <td>2023-11-09..11</td> <td>CN Tower em Toronto / Casa em NYC</td> <td>Presente (do Tony)</td> </tr> <tr><td>47</td> <td>Paranaguá Train</td> <td>2023-11-09..11</td> <td>Casa em NYC</td> <td>Presente (do Tony)</td> </tr> <tr><td>48</td> <td>Wonderville Arcade Machine</td> <td>2023-11-10</td> <td>Wonderville em NYC</td> <td>Compra</td> </tr> <tr><td>49</td> <td>Mask — Mr. Robot</td> <td>2023-11-15</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>50</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/products/squidward-at-work-spongebob-squarepants-pin">Squidward At Work — Spongebob Squarepants</a></td> <td>2023-12-01</td> <td>Casa em NYC</td> <td>Presente (de Mãe)</td> </tr> <tr><td>51</td> <td>Penguin</td> <td>2023-12-01</td> <td>Casa em NYC</td> <td>Presente (de Mãe)</td> </tr> <tr><td>52</td> <td>Outback &#64;</td> <td>2023-12-03 (originalmente ~2010)</td> <td>Casa em São Paulo</td> <td>Presente (de Mãe)</td> </tr> <tr><td>53</td> <td>Outback Steakhouse Sign</td> <td>2023-12-03 (originalmente ~2010)</td> <td>Casa em São Paulo</td> <td>Presente (de Mãe)</td> </tr> <tr><td>54</td> <td>Paper Boat</td> <td>2023-12-09..15</td> <td>Cruzeiro para o nordeste do Brasil</td> <td>Compra</td> </tr> <tr><td>55</td> <td>Magic The Gathering Card Back</td> <td>2023-12-15..2024-01-27</td> <td>SoGo Plaza Shopping em São Paulo</td> <td>Compra</td> </tr> <tr><td>56</td> <td>Odish — Pokémon</td> <td>2023-12-15..2024-01-27</td> <td>SoGo Plaza Shopping em São Paulo</td> <td>Compra</td> </tr> <tr><td>57</td> <td><a class="reference external" href="https://topatoco.com/collections/pins-and-patches/products/kcg-thisfine-pins?variant=1867673042959">This Is Fine (First Panel)</a></td> <td>2024-05-29</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>58</td> <td><a class="reference external" href="https://topatoco.com/products/cpb-wtnv-pins01?_pos=2&amp;_sid=ba14eae20&amp;_ss=r&amp;variant=30297717964911">All Hail The Glow Cloud — Welcome to Night Vale</a></td> <td>2024-05-29</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>59</td> <td><a class="reference external" href="https://topatoco.com/products/won-pins-01?variant=31246520451183">Spelcheck</a></td> <td>2024-05-29</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>60</td> <td>Donut</td> <td>2024-06-01..2024-08-01</td> <td>Loja de presentes no Bryant Park</td> <td>Compra</td> </tr> <tr><td>61</td> <td><a class="reference external" href="https://www.pintrill.com/collections/peanuts/products/peanuts-originals-schroeder-pin">Schroeder — Peanuts</a></td> <td>2024-06-01..2024-08-01</td> <td>Loja Newtown HQ em NYC</td> <td>Compra</td> </tr> <tr><td>62</td> <td>New York Pidgeon</td> <td>2024-06-01..2024-08-01</td> <td>Loja Newtown HQ em NYC</td> <td>Compra</td> </tr> <tr><td>63</td> <td>New York Sewer</td> <td>2024-06-01..2024-08-01</td> <td>Loja Newtown HQ em NYC</td> <td>Compra</td> </tr> <tr><td>64</td> <td>Groundon — Pokémon</td> <td>2024-06-01..2024-08-01</td> <td>Loja Say Cheese em NYC</td> <td>Compra</td> </tr> <tr><td>65</td> <td>Pikachu — Pokémon</td> <td>2024-06-01..2024-08-01</td> <td>Loja Say Cheese em NYC</td> <td>Compra</td> </tr> <tr><td>66</td> <td>MTA Logo</td> <td>2024-08-16</td> <td>New York Transit Museum</td> <td>Compra</td> </tr> <tr><td>67</td> <td>Dollyinho</td> <td>2024-09-21</td> <td>Viena, Áustria</td> <td>Presente (do Tony)</td> </tr> <tr><td>68</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/collections/spongebob-squarepants/products/imagination-spongebob-squarepants-pin">Imagination! — Spongebob Squarepants</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>69</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/collections/spongebob-squarepants/products/mr-krabs-worlds-smallest-violin-spongebob-squarepants-pin">Mr. Krabs' World's Smallest Violin — Spongebob Squarepants</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>70</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/collections/spongebob-squarepants/products/nail-in-head-patrick-spongebob-squarepants-pin">Nail in Head Patrick — Spongebob Squarepants</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>71</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/collections/spongebob-squarepants/products/shocked-patrick-spongebob-squarepants-pin">Shocked Patrick — Spongebob Squarepants</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>72</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/products/speedy-sonic-classic-sonic-the-hedgehog-collectible-pin">Speedy Sonic — Classic Sonic The Hedgehog</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>73</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/products/pizza-drooling-gir-invader-zim-pin">Pizza Slurpin' Gir — Invader Zim</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>74</td> <td><a class="reference external" href="https://www.zenmonkeystudios.com/products/aang-on-air-scooter-avatar-the-last-airbender-pin">Aang On Air Scooter — Avatar: The Last Airbender</a></td> <td>2024-10-17</td> <td>Estande do Zen Monkey Studios na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>75</td> <td>Mr. Incredible — The Incredibles</td> <td>2024-10-17</td> <td>Disney pin trading event at New York Comic Con 2024</td> <td>Troca</td> </tr> <tr><td>76</td> <td><a class="reference external" href="https://www.pintradingdb.com/pin/58254">Woody, Buzz Lightyear &amp; Jessie — Toy Story</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>77</td> <td><a class="reference external" href="https://www.pintradingdb.com/pin/52091">Randall Boggs with Scream Canister — Monsters Inc.</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>78</td> <td>The One Ring — The Lord of the Rings</td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>79</td> <td><a class="reference external" href="https://numskull.com/products/official-pac-man-9-pin-set">Pacman</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>80</td> <td><a class="reference external" href="https://www.pintradingdb.com/pin/56930">Chicken Little</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>81</td> <td><a class="reference external" href="https://www.hottopic.com/product/kirby-enamel-pin-set/33449656.html">Warp Star Kirby</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>82</td> <td><a class="reference external" href="https://www.hottopic.com/product/kirby-enamel-pin-set/33449656.html">Kirby</a></td> <td>2024-10-17</td> <td>Estande de pins na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>83</td> <td>Coraline</td> <td>2024-10-17</td> <td>Estande da Spooksieboo na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>84</td> <td>BFF Frog</td> <td>2024-10-17</td> <td>Estande de mercadorias da NYCC na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>85</td> <td>BFF Rat</td> <td>2024-10-17</td> <td>Estande de mercadorias da NYCC na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>86</td> <td>NYCC</td> <td>2024-10-17</td> <td>Estande de mercadorias da NYCC na New York Comic Con 2024</td> <td>Compra</td> </tr> <tr><td>87</td> <td><a class="reference external" href="https://www.etsy.com/listing/905102480/ouroboros-symbol-aluminum-metal-resin">Ouroboros — Fullmetal Alchemist</a></td> <td>2024-10-26</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>88</td> <td><a class="reference external" href="https://www.gallerynucleus.com/detail/23589/">Greg — Over The Garden Wall</a></td> <td>2024-10-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>89</td> <td>Spectacle Logo</td> <td>2024-11-02</td> <td>Spectacle Theater em NYC</td> <td>Compra</td> </tr> <tr><td>90</td> <td>Crash Bandicoot</td> <td>2024-12-10</td> <td>Corrida de uber indo para um parque de trapolim em São Paulo</td> <td>Presente (da Marianna)</td> </tr> <tr><td>91</td> <td>Black Cat In Bucket</td> <td>2024-12-10</td> <td>Corrida de uber indo para um parque de trapolim em São Paulo</td> <td>Presente (da Marianna)</td> </tr> <tr><td>92</td> <td>Zé Gotinha</td> <td>2025-01-12</td> <td>Casa do Tony</td> <td>Presente (do Tony)</td> </tr> <tr><td>93</td> <td>Tudor Rose</td> <td>2025-01-18</td> <td>Casa do Tony</td> <td>Presente (do Tony)</td> </tr> <tr><td>94</td> <td><a class="reference external" href="https://www.icebrg.com.br/irmao">Irmão Do Jorel</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>95</td> <td><a class="reference external" href="https://www.icebrg.com.br/coco">Coco Mágico — Irmão do Jorel</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>96</td> <td><a class="reference external" href="https://www.icebrg.com.br/1963">Mônica 1963 — Turma da Mônica</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>97</td> <td><a class="reference external" href="https://www.icebrg.com.br/sansao">Sansão — Turma da Mônica</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>98</td> <td><a class="reference external" href="https://www.icebrg.com.br/ratinho">Ratinho — Castelo Rá Tim Bum</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>99</td> <td><a class="reference external" href="https://www.icebrg.com.br/senta">Senta Que Lá Vem História — Castelo Rá Tim Bum</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>100</td> <td><a class="reference external" href="https://www.icebrg.com.br/minhocao">Minhocão</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>101</td> <td><a class="reference external" href="https://www.icebrg.com.br/liberdade">Liberdade</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>102</td> <td><a class="reference external" href="https://www.icebrg.com.br/cavaquinho">Cavaquinho</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>103</td> <td><a class="reference external" href="https://www.icebrg.com.br/saojorge">São Jorge</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>104</td> <td><a class="reference external" href="https://www.icebrg.com.br/capivara">Capivara</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>105</td> <td><a class="reference external" href="https://www.icebrg.com.br/piso">Piso de Caquinho</a></td> <td>2025-01-20</td> <td>Loja Santa Hell na Galeria do Rock em São Paulo</td> <td>Compra</td> </tr> <tr><td>106</td> <td><a class="reference external" href="https://www.icebrg.com.br/luckycat">Lucky Cat</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>107</td> <td><a class="reference external" href="https://www.icebrg.com.br/andorinha">Andorinha</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>108</td> <td><a class="reference external" href="https://www.icebrg.com.br/fliper">Fliperama</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>109</td> <td><a class="reference external" href="https://www.icebrg.com.br/bilhete">Metrô SP</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>110</td> <td><a class="reference external" href="https://www.icebrg.com.br/augusta">Rua Augusta</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>111</td> <td><a class="reference external" href="https://www.icebrg.com.br/brasil">Bandeira Brasil</a></td> <td>2025-01-30</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>112</td> <td>Tv Cultura</td> <td>2025-02-02</td> <td>Feira de rua perto da Av. Paulista em São Paulo</td> <td>Compra</td> </tr> <tr><td>113</td> <td>Globo</td> <td>2025-02-02</td> <td>Feira de rua perto da Av. Paulista em São Paulo</td> <td>Compra</td> </tr> <tr><td>114</td> <td>Linux Conectiva</td> <td>2025-02-02</td> <td>Feira de rua perto da Av. Paulista em São Paulo</td> <td>Compra</td> </tr> <tr><td>115</td> <td>Windows 2000</td> <td>2025-02-02</td> <td>Feira de rua perto da Av. Paulista em São Paulo</td> <td>Compra</td> </tr> <tr><td>116</td> <td>ABNT</td> <td>2025-02-02</td> <td>Feira de rua perto da Av. Paulista em São Paulo</td> <td>Compra</td> </tr> <tr><td>117</td> <td><a class="reference external" href="https://www.etsy.com/listing/4302174034/daft-punk-pin-enamel-lapel-alive">Daft Punk</a></td> <td>2025-03-18</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>118</td> <td><a class="reference external" href="https://www.etsy.com/listing/1030452012/chrono-trigger-for-snes-chrono-trigger">Chrono Trigger</a></td> <td>2025-03-27</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>119</td> <td><a class="reference external" href="https://www.etsy.com/listing/1724710918/sims-plumbob-mini-enamel-pin">Plumbob — The Sims</a></td> <td>2025-03-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>120</td> <td><a class="reference external" href="https://www.etsy.com/listing/1570559383/cardcaptor-sealing-key-mini-enamel-pin">Cardcaptor Sealing Key — Cardcaptor Sakura</a></td> <td>2025-03-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>121</td> <td><a class="reference external" href="https://www.etsy.com/listing/1570493833/triforce-mini-enamel-pin">Triforce — Zelda</a></td> <td>2025-03-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>122</td> <td><a class="reference external" href="https://www.etsy.com/listing/1608102952/red-cloud-mini-enamel-pin">Akatsuki — Naruto</a></td> <td>2025-03-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>123</td> <td><a class="reference external" href="https://www.etsy.com/listing/1516361510/nostalgic-video-game-characters-pins-vol">Klonoa</a></td> <td>2025-03-28</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>124</td> <td><a class="reference external" href="https://www.compressmerch.com/collections/finji/products/love_from_wilmot_pinny">Love From Wilmot — Wilmot’s Warehouse</a></td> <td>2025-04-26</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>125</td> <td><a class="reference external" href="https://www.compressmerch.com/products/usual-june-pinny-arcade-enamel-pin?variant=44932087873698">Usual June</a></td> <td>2025-04-26</td> <td>Online</td> <td>Compra</td> </tr> <tr><td>126</td> <td>Hope Hammer — Godspeed You! Black Emperor</td> <td>2025-06-27</td> <td>Show do Godspeed You Black Emperor no District Music Hall em Norwalk, CT</td> <td>Compra</td> </tr> <tr><td>127</td> <td>Javascript</td> <td>2025-08-07</td> <td>Encontro do Astoria Tech Meetup</td> <td>Presente (de Tea)</td> </tr> <tr><td>128</td> <td><a class="reference external" href="https://www.etsy.com/listing/1780904874/fez-gomez-1-enamel-pin-and-magnet">Gomez — FEZ</a></td> <td>2025-08-09</td> <td>Long Island Retro Gaming Expo no Cradle of Aviation Museum</td> <td>Compra</td> </tr> </tbody> </table> <p>[*] O pin do logo da Collabora não está nas fotos porque ele é magnético, mas você pode vê-lo no artigo anterior.</p> <p>A planilha completa não coube nessa página, então a tabela acima contém apenas as principais colunas. Você pode baixar a planilha completa no link abaixo que também inclui a autenticidade e fabricante do pin e comentários adicionais:</p> <p><a class="reference external" href="https://nfraprado.net/pt-br/files/pins-spreadsheet/pins.ods">Planilha de pins</a></p> Música do Mês: Soundgarden - Black Hole Sun2025-08-31T00:00:00-03:002025-08-31T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-08-31:/pt-br/post/musica-do-mes-soundgarden-black-hole-sun.html<p>Anteontem eu fui numa experiência teatral imersiva chamada <a class="reference external" href="https://www.theshed.org/program/444-violas-room">Viola's Room</a>. Ela começou no quarto de uma menina, com luzes fracas e algumas camas no chão como em uma festa do pijama. Nos fones de ouvido, uma linda música começou a tocar. O momento foi tão mágico que é difícil de …</p><p>Anteontem eu fui numa experiência teatral imersiva chamada <a class="reference external" href="https://www.theshed.org/program/444-violas-room">Viola's Room</a>. Ela começou no quarto de uma menina, com luzes fracas e algumas camas no chão como em uma festa do pijama. Nos fones de ouvido, uma linda música começou a tocar. O momento foi tão mágico que é difícil de descrever. Eu me senti como uma criança de novo por um segundo. E eu soube que eu sempre lembraria desse momento no futuro (<a class="reference external" href="https://www.thedictionaryofobscuresorrows.com/concept/des-vu">dès vu</a>). Se você tiver a chance de ir, eu recomendo demais.</p> <p>De qualquer forma, a música que estava tocando, que eu descobri mais tarde, é a minha música do mês para agosto:</p> <p><a class="reference external" href="https://www.youtube.com/watch?v=3mbBbFH9fAg">Soundgarden - Black Hole Sun</a></p> Música do Mês: Junko Yagami - Bay City2025-08-12T00:00:00-03:002025-08-12T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-08-12:/pt-br/post/musica-do-mes-junko-yagami-bay-city.html<p>Hoje eu quero tentar começar algo novo. Todo mês eu vou compartilhar uma música que se destacou pra mim durante o mês.</p> <p>Pra essa primeira, apesar de já estar no meio de agosto, eu sinto que eu preciso compartilhar essa música que marcou meus dias de julho e inclusive junho …</p><p>Hoje eu quero tentar começar algo novo. Todo mês eu vou compartilhar uma música que se destacou pra mim durante o mês.</p> <p>Pra essa primeira, apesar de já estar no meio de agosto, eu sinto que eu preciso compartilhar essa música que marcou meus dias de julho e inclusive junho. Muitas das minhas caminhadas pela cidade em dias ensolarados foram acompanhadas por ela, fazendo dessa música o hino desse verão pra mim.</p> <p>Sem mais delongas, minha música do mês pra julho é</p> <p><a class="reference external" href="https://www.youtube.com/watch?v=QLHMhVonF-s">Junko Yagami - Bay City</a></p> Um novo tema para o blog (agora com 0% JavaScript!)2025-05-04T00:00:00-03:002025-05-04T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2025-05-04:/pt-br/post/um-novo-tema-para-o-blog-agora-com-0-javascript.html<p>Recentemente eu atualizei o tema do blog e achei que seria bom escrever um artigo não só para registrar a razão mas também para arquivar fotos do blog antes e depois da mudança para o futuro.</p> <p>Quando eu criei esse blog, eu escolhi o <a class="reference external" href="https://github.com/gunchu/nikhil-theme">nikhil-theme</a> como tema por ser minimalista …</p><p>Recentemente eu atualizei o tema do blog e achei que seria bom escrever um artigo não só para registrar a razão mas também para arquivar fotos do blog antes e depois da mudança para o futuro.</p> <p>Quando eu criei esse blog, eu escolhi o <a class="reference external" href="https://github.com/gunchu/nikhil-theme">nikhil-theme</a> como tema por ser minimalista e bonito. (Mais bonito ainda depois que troquei as fontes para serem iguais às do blog <a class="reference external" href="https://www.thirtythreeforty.net/">https://www.thirtythreeforty.net/</a>)</p> <p>Porém algum tempo depois conforme eu estava olhando os arquivos de <em>template</em> HTML do tema, eu fiquei surpreso ao descobrir que esse tema tão simples continha JavaScript. Eu tentei carregar a página com o JavaScript removido e percebi que ele era necessário apenas para expandir o menu hambúrguer em dispositivos móveis. Isso me incomodou bastante. Um simples blog como esse não deveria precisar de JavaScript nenhum. E o mais irritante é ele ser necessário por causa de uma única funcionalidade.</p> <p>Mas na hora eu já estava fazendo outras mudanças no blog e não estava a fim de ter que mudar de tema também, então deixei essa tarefa para o futuro, até recentemente, quando eu finalmente decidi tomar alguma atitude.</p> <p>Para decidir qual seria o novo tema do blog, eu comecei olhando em <a class="reference external" href="https://github.com/getpelican/pelican-themes">pelican-themes</a> (o mesmo lugar onde eu originalmente descobri o nikhil-theme), mas só achei um ou outro tema que não usava JavaScript e eles não me interessaram.</p> <p>Eventualmente eu lembrei do blog <a class="reference external" href="https://seirdy.one/">seirdy.one</a>. É um blog que eu acompanho que tem artigos excelentes e ele tem <a class="reference external" href="https://seirdy.one/meta/site-design/">uma página inteira sobre as normas de design</a> que o site segue. Esses normas focam em minimalismo, compatibilidade e acessibilidade, que são todas qualidades que eu gostaria para o meu blog, então eu escolhi adotar o tema do Seirdy para o meu blog.</p> <p>Olhando pelo <a class="reference external" href="https://git.sr.ht/~seirdy/seirdy.one">código fonte do blog seirdy</a> eu notei que ele usa o gerador de site estático <a class="reference external" href="https://gohugo.io/">Hugo</a> enquanto o meu usa <a class="reference external" href="https://getpelican.com/">pelican</a>, então adaptar esse tema não seria só questão de copiar e colar.</p> <p>Idealmente eu teria revisado os <em>templates</em> HTML do Seirdy e entendido todos eles para conseguir adaptá-los para os <em>templates</em> HTML em Jinja2 para o pelican, mas honestamente eu não estava com toda essa energia. Então eu fui pela solução preguiçosa: eu copiei os arquivos CSS e ajustei meus <em>templates</em> até o site aparentar razoável. Ou seja, eu provavelmente não estou seguindo várias das normas do Seirdy, mas pelo menos foi o suficiente para deixar o site mais leve, sem nenhum JS (e nem CSS externo), que era o objetivo principal.</p> <p>A mudança de código que resultou disso pode ser vista <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/4be0e1d84495f3186a0811f1d184062e63fe1f21">nesse commit</a> (e também <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/6f82039f935841dc1fc09c968c48f796528e5123">nesse</a> e <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/ff36f3cdb1e1bd3fcb62763afccecdbf9ca31508">nesse</a> para consertos posteriores).</p> <p>Já quanto à mudança visual do site, as fotos abaixo mostram as diferentes páginas antes e depois da mudança do tema, respectivamente.</p> <p>Página principal:</p> <img alt="{image}/before-home.png" src="/images/blog-theme-seirdy-update/before-home.png" /> <img alt="{image}/after-home.png" src="/images/blog-theme-seirdy-update/after-home.png" /> <p>Um artigo:</p> <img alt="{image}/before-post.png" src="/images/blog-theme-seirdy-update/before-post.png" /> <img alt="{image}/after-post.png" src="/images/blog-theme-seirdy-update/after-post.png" /> <p>Categorias:</p> <img alt="{image}/before-tags.png" src="/images/blog-theme-seirdy-update/before-tags.png" /> <img alt="{image}/after-tags.png" src="/images/blog-theme-seirdy-update/after-tags.png" /> <p>Sobre:</p> <img alt="{image}/before-about.png" src="/images/blog-theme-seirdy-update/before-about.png" /> <img alt="{image}/after-about.png" src="/images/blog-theme-seirdy-update/after-about.png" /> <p>Não vou mentir, eu já me sinto nostálgico e um pouco triste de ver o tema antigo ir embora, mas eu acho que tornar o site mais minimalista vale a pena.</p> <p>Uma coisa perdida nessa transição foi o <em>syntax highlight</em> para blocos de código. Eu suponho que seja intencionalmente evitado pelo Seirdy por conta de preocupações com a acessibilidade, mas eu deveria confirmar isso eventualmente e se não for o caso, considerar adicioná-lo de volta.</p> <p>Apesar de ainda restarem detalhes para acertar, eu estou bem feliz com a mudança e particularmente aliviado de não ter mais JavaScript rodando quando alguém vê esse blog.</p> Em busca do colar de pins perfeito2024-11-16T00:00:00-03:002024-11-16T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2024-11-16:/pt-br/post/em-busca-do-colar-de-pins-perfeito.html<p>Ano passado, no <a class="reference external" href="/pt-br/post/colecionando-pins.html">artigo "Colecionando pins"</a>, eu mencionei que eu geralmente uso meus pins na touca, mas que ainda estava procurando uma boa alternativa para dias quentes.</p> <p>Depois de pensar mais um pouco, eu concluí que um colar seria uma boa opção. Ele não depende de nenhuma peça de roupa …</p><p>Ano passado, no <a class="reference external" href="/pt-br/post/colecionando-pins.html">artigo "Colecionando pins"</a>, eu mencionei que eu geralmente uso meus pins na touca, mas que ainda estava procurando uma boa alternativa para dias quentes.</p> <p>Depois de pensar mais um pouco, eu concluí que um colar seria uma boa opção. Ele não depende de nenhuma peça de roupa específica e é bem visível, tanto para os outros quanto para mim.</p> <p>Eu comecei a pesquisar por colares de pin e encontrei algumas soluções para o conversor de pin para colar:</p> <ul class="simple"> <li><a class="reference external" href="https://www.epbot.com/2020/04/quick-craft-turn-any-disney-pin-into.html">Guia DIY: Conversor usando tarraxa de borracha</a></li> <li><a class="reference external" href="https://www.etsy.com/listing/1672516454/clearrings-necklace-converter-enamel-pin">Comprar: Conversor usando plástico transparente</a></li> <li><a class="reference external" href="https://www.etsy.com/listing/607824060/enamel-pin-necklace-converter-wear-your?show_sold_out_detail=1&amp;ref=nla_listing_details">Comprar: Conversor usando um pedaço de couro</a></li> <li><a class="reference external" href="https://cosmicmedium.com/products/lapel-pin-necklace-lock-converter?variant=40404834123973">Comprar: Conversor usando tarraxa com trava</a></li> </ul> <p>O guia é ótimo, mas eu não acho que tarraxas de borracha são seguras o suficiente. E eu não achei o conversor de plástico nem o de couro bonitos. Mas o de tarraxa com trava pareceu perfeito! Então eu comprei um na hora.</p> <p>Na verdade, eu comprei dois. O motivo é que alguns pins tem dois pinos, um do lado do outro, então duas tarraxas seriam necessárias para deixar esses pins orientados corretamente no colar (veja as fotos no final). Comprando dois colares eu poderia transferir o conversor de um deles para o outro e ter um colar com dois conversores, o que me permitiria usar qualquer pin da minha coleção.</p> <p>Porém assim que o colar chegou e eu comecei a usá-lo, ficou claro que ele tinha um grande problema: o pin ficava virando o tempo todo! Isso acaba com o propósito do colar. Eu concluí que o problema era a corrente, que tinha que ser trocada por algo mais rígido, como um cordão de couro. Eu escolhi este colar de couro trançado (a variante de 20 polegadas de comprimento e 3 milímetros de diâmetro): <a class="reference external" href="https://www.amazon.com/Flexible-Braided-Leather-Necklace-Pendants/dp/B095W7J7D7">https://www.amazon.com/Flexible-Braided-Leather-Necklace-Pendants/dp/B095W7J7D7</a></p> <p>Assim que ele chegou, eu peguei dois alicates, dois anéis de metal próprios para bijuteria (já que os originais não iriam fechar nesse colar mais grosso) e usei eles para colocar os dois conversores de pin no novo colar. E funcionou perfeitamente, os pins não viraram mais! Eu também gostei mais da nova aparência, a corrente era muito brilhante e fina para o meu gosto.</p> <p>Além disso, como os anéis que eu usei são bem mais largos que o colar, é muito fácil de tirar e pôr os conversores de pin. Graças a isso, quando eu estou usando um pin que só usa um conversor, eu tiro o outro para não deixar ele pendurado fazendo barulho.</p> <p>Finalmente, aqui estão as fotos do resultado final:</p> <p>Pin de um pino:</p> <img alt="{image}/df-front.jpg" src="/images/pin-necklace/df-front.jpg" /> <img alt="{image}/df-back.jpg" src="/images/pin-necklace/df-back.jpg" /> <p>Pin de dois pinos:</p> <img alt="{image}/lotr-front.jpg" src="/images/pin-necklace/lotr-front.jpg" /> <img alt="{image}/lotr-back.jpg" src="/images/pin-necklace/lotr-back.jpg" /> <p>Colar no corpo:</p> <img alt="{image}/df-wear.jpg" src="/images/pin-necklace/df-wear.jpg" /> <img alt="{image}/lotr-wear.jpg" src="/images/pin-necklace/lotr-wear.jpg" /> <p>O único problema é que os pins de um pino, como o do Dwarf Fortress acima, sempre ficam virados para o lado. Mas eu acho que não tem como evitar isso em um colar. De qualquer forma, é só um detalhe e eu estou extremamente feliz com o resultado. Eu tenho usado pins todo dia desde então!</p> CardOS: Agora compilando sem Arduino!2024-07-31T00:00:00-03:002024-07-31T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2024-07-31:/pt-br/post/cardos-agora-compilando-sem-arduino.html<p>No <a class="reference external" href="/pt-br/post/cardos-escrevendo-um-so-para-o-cardputer.html">artigo "CardOS: Escrevendo um SO para o Cardputer"</a> eu falei sobre o SO que eu estou escrevendo para o Cardputer e que o próximo passo era remover a dependência da toolchain do Arduino. Levou dois meses mas finalmente eu consegui. O produto final foi <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/85553f797cf0877e4c88a8e549052a445d00e7d1">esse commit</a> mas eu gostaria …</p><p>No <a class="reference external" href="/pt-br/post/cardos-escrevendo-um-so-para-o-cardputer.html">artigo "CardOS: Escrevendo um SO para o Cardputer"</a> eu falei sobre o SO que eu estou escrevendo para o Cardputer e que o próximo passo era remover a dependência da toolchain do Arduino. Levou dois meses mas finalmente eu consegui. O produto final foi <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/85553f797cf0877e4c88a8e549052a445d00e7d1">esse commit</a> mas eu gostaria de descrever o processo para chegar até aqui neste artigo.</p> <p>Eu comecei rodando os comandos do Arduino para compilar e gravar com saída <em>verbose</em> habilitada e salvando essa saída em um arquivo para usar de referência. Assim eu conseguiria ver exatamente o que o Arduino estava fazendo e entender as etapas necessárias para ir do código-fonte até o binário gravado na memória da placa.</p> <p>Então eu fiz as mudanças óbvias para converter de Arduino para C: Eu renomeei o único arquivo de código-fonte do projeto de <code class="docutils literal">cardOS.ino</code> para <code class="docutils literal">cardOS.c</code>, converti as funções <code class="docutils literal">setup</code> e <code class="docutils literal">loop</code> em uma função <code class="docutils literal">main</code>, e mudei a etapa de compilação no meu Makefile para ao invés de chamar o Arduino, chamar o compilador cruzado de C para a ESP32 (<code class="docutils literal">xtensa-esp32s3-elf-gcc</code>), que já havia sido instalado na minha máquina pelo Arduino e cujo caminho eu descobri pela saída do Arduino.</p> <p>Em seguida eu rodei a compilação, e consertei cada erro que o compilador gerou. Especificamente, eu tive que adicionar alguns includes, protótipos de funções, mudar o jeito que algumas variáveis eram definidas e passar o parâmetro <code class="docutils literal">-fno-builtin</code> para o compilador para que ele me deixasse definir minhas próprias funções da stdlib. Feito isso, eu agora tinha um arquivo <a class="reference external" href="https://en.wikipedia.org/wiki/Executable_and_Linkable_Format">ELF</a> e precisava descobrir como gravar ele na placa.</p> <p>Lendo por cima a saída do Arduino, eu aprendi que <code class="docutils literal">esptool.py</code> era o comando usado para converter o arquivo ELF em um binário, e que ele era chamado de novo para gravar o binário na placa. Além do código da aplicação, outras coisas também estavam sendo gravadas: um bootloader e uma tabela de partição. Para não complicar, eu fiz um pequeno teste para verificar se eu podia ignorar eles por enquanto (ou seja, presumir que eles já estavam gravados): Eu fiz uma pequena mudança no código do SO e usei a toolchain do Arduino para compilar e gravar apenas ele e vi que a mudança apareceu no Cardputer, então a resposta era sim.</p> <p>Com isso em mente, eu atualizei o Makefile para chamar o <code class="docutils literal">esptool.py</code> para converter o ELF gerado pelo compilador e então gravar na placa. A esta altura, eu já tinha resolvido (eu achava) todo o procedimento para ir do código-fonte até o binário gravado na placa, então eu rodei ele com <code class="docutils literal">make upload</code>. Mas não funcionou, a tela no Cardputer nem ligava.</p> <p>Eu percebi que presumir que todo o código fosse funcionar de cara no novo procedimento era muito otimista e decidi simplificar o teste o máximo possível: Eu mudei o código na <code class="docutils literal">main</code> para apenas ligar o pino GPIO1 e conectei o pino a um LED. Mas ainda assim, o LED não ligou.</p> <p>Foi aqui que eu fiquei travado por um tempo. O problema estava claramente no binário da aplicação em algum lugar. Minhas duas teorias eram que ou o binário em si tinha algum problema, ou algum código de inicialização estava faltando, já que o Arduino incluia vários arquivos adicionais durante a compilação.</p> <div class="section" id="configurando-os-enderecos-no-arquivo-elf"> <h2>Configurando os endereços no arquivo ELF</h2> <p>Na esperança de que o problema era no binário em si, já que identificar código de inicialização do Arduino que estivesse fazendo falta parecia mais difícil, eu decidi começar a investigar ele.</p> <p>Eu usei o <code class="docutils literal">readelf</code> para ver o conteúdo tanto do meu ELF quando do gerado pelo Arduino e comparei eles. A maior differença no header foi essa:</p> <p>Meu:</p> <pre class="code literal-block"> Entry point address: 0x40017d </pre> <p>Arduino:</p> <pre class="code literal-block"> Entry point address: 0x40376778 </pre> <p>O ELF do Arduino tinha muito mais código, então eu já esperava que ele fosse ter endereços maiores, mas essa diferença era grande demais. Parecia que algum endereço de base diferente estava sendo usado.</p> <p>Eu pesquisei o significado do &quot;Entry point address&quot; em um ELF e confirmei que esse é o endereço de onde começa a execução. Então errar esse endereço com certeza faria meu código nem executar.</p> <p>Olhando mais adiante no conteúdo do ELF:</p> <p>Meu:</p> <pre class="code literal-block"> Program Headers: Type Offset VirtAddr PhysAddr FileSiz MemSiz Flg Align LOAD 0x000000 0x00400000 0x00400000 0x0183c 0x0183c R E 0x1000 LOAD 0x00183c 0x0040283c 0x0040283c 0x001a1 0x0075c RW 0x1000 Section to Segment mapping: Segment Sections... 00 .text .rodata .eh_frame 01 .ctors .dtors .data .bss </pre> <p>Arduino:</p> <pre class="code literal-block"> Program Headers: Type Offset VirtAddr PhysAddr FileSiz MemSiz Flg Align LOAD 0x001020 0x3c000020 0x3c000020 0x2a678 0x2a678 RW 0x1000 LOAD 0x02c000 0x3fc88000 0x3fc88000 0x0c018 0x0d8a8 RW 0x1000 LOAD 0x039000 0x40374000 0x40374000 0x0ca97 0x0ca98 RWE 0x1000 LOAD 0x046020 0x42000020 0x42000020 0x1f347 0x1f347 R E 0x1000 LOAD 0x000000 0x50000000 0x50000000 0x00000 0x00010 RW 0x1000 Section to Segment mapping: Segment Sections... 00 .flash_rodata_dummy .flash.appdesc .flash.rodata 01 .dram0.dummy .dram0.data .dram0.bss 02 .iram0.vectors .iram0.text .iram0.data 03 .flash.text 04 .rtc_noinit </pre> <p>Depois de ler na internet sobre <em>program headers</em> e <em>sections</em> em um ELF, tudo isso começou a fazer sentido.</p> <p>Olhando em &quot;program headers&quot; no ELF do Arduino, realmente há um endereço muito próximo do &quot;entry point address&quot;: <code class="docutils literal">0x40374000</code> no segmento 2. Esse é o endereço de base que eu estava suspeitando. O código que começa a executar então deve estar na seção <code class="docutils literal">iram0.text</code>, já que seções com <code class="docutils literal">text</code> no nome representam código e essa é a que está mapeada ao segmento 2. As perguntas que vem à mente são:</p> <ul class="simple"> <li>Por que esse endereço é usado?</li> <li>Como eu configuro esse endereço no meu arquivo ELF?</li> </ul> <p>Para responder a primeira pergunta, eu fui olhar no <a class="reference external" href="https://www.espressif.com/sites/default/files/documentation/esp32-s3_technical_reference_manual_en.pdf">manual do ESP32-S3</a>. A figura 4-1 mostra um diagrama de como cada região de memória é mapeada. O endereço inicial do segmento usado para o código de entrada no Arduino, <code class="docutils literal">0x40374000</code>, está dentro da região <code class="docutils literal">0x40370000 - 0x403dffff</code> que está mapeada à SRAM através de um barramento de instruções, o que faz todo sentido!</p> <p>Mas lendo mais adiante, a tabela 4-1 subdivide as regiões de memória e dá o nome de &quot;Internal SRAM0&quot; para a região contendo <code class="docutils literal">0x40374000</code>. Em sua descrição, é mencionado que os primeiros 16KB do espaço podem ser reservados como cache para instruções armazenados na memória flash. Fazendo as contas, isso significa que a memória usável para instruções começa em... <code class="docutils literal">0x40374000</code>, exatamente o endereço que foi usado para o segmento contendo código no ELF do Arduino! Então isso explica de onde esse endereço veio.</p> <p>Em resumo, o problema que eu descobri foi que o arquivo ELF que eu estava gerando tinha o código associado a endereços que não mapeiam para uma região de memória que pode ser acessada pelo processador do ESP32 para ler instruções (ou seja, acessível através de um barramento de instruções) e por isso não podia ser executado.</p> <p>O que estava faltando era responder a segunda pergunta: Como eu configuro o endereço certo no meu arquivo ELF?</p> <p>Isso era um grande lacuna no meu conhecimento, eu não fazia ideia. Mas olhando na saída do Arduino, eu vi que o compilador estava sendo passado alguns arquivos <code class="docutils literal">.ld</code> através de um parâmetro <code class="docutils literal">-T</code>. Dentro de um deles chamado <code class="docutils literal">memory.ld</code> eu encontrei alguns endereços sendo definidos! A definição do parâmetro <code class="docutils literal">-T</code> no manual do compilador revelou que esses arquivos eram <em>linker scripts</em>, então eu já sabia a próxima coisa que eu precisava aprender.</p> <p>Eu encontrei <a class="reference external" href="https://allthingsembedded.com/post/2020-04-11-mastering-the-gnu-linker-script/">esse excelente artigo sobre linker scripts</a> que me ensinou tudo que eu precisava saber. Com essa informação eu consegui escrever meu <em>linker script</em> e associar os endereços corretos a cada seção do ELF: Não só para o código (<code class="docutils literal">.text</code>), mas também para as variáveis inicializadas em zero (<code class="docutils literal">.bss</code>) e outras variáveis (<code class="docutils literal">.data</code>), cujos endereços eu descobri do mesmo jeito olhando o manual e o ELF do Arduino. Algumas seções adicionais também tiveram que ser declaradas para resolver erros no linker.</p> <p>Como você pode ter reparado nos conteúdos dos ELF, o do Arduino tem duas seções de código, <code class="docutils literal">iram0.text</code> e <code class="docutils literal">flash.text</code>, enquanto o meu só tem uma, <code class="docutils literal">.text</code>. Por esse motivo eu inicialmente decidi apontar minha seção <code class="docutils literal">.text</code> para a memória flash já que ela tem muito mais espaço. Porém o Cardputer ainda não mostrou nenhum sinal de vida. Já que eu percebi que meu código era pequeno o suficiente para caber inteiramente na SRAM, e o código do Arduino começava na SRAM, eu decidi experimentar isso, e funcionou!!</p> <img alt="{image}/led.jpg" src="/images/cardos-without-arduino/led.jpg" /> <p>A documentação do <a class="reference external" href="https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/startup.html#second-stage-bootloader">procedimento de inicialização da aplicação</a> do ESP-IDF descreve o que o bootloader do segundo estágio (que é o que eu ainda estou usando do Arduino) faz e não faz, e ela menciona que é responsabilidade da aplicação acabar de configurar a <a class="reference external" href="https://en.wikipedia.org/wiki/Memory_management_unit">MMU</a> da memória flash. Esse provavelmente é o motivo pelo qual usar o endereço da memória flash para o código não funcionou e porque o Arduino divide o código entre uma parte na SRAM e outra na flash. Então em algum momento eu vou precisar configurar o acesso a flash, mas por enquanto a SRAM era o suficiente.</p> </div> <div class="section" id="codigo-de-inicializacao"> <h2>Código de inicialização</h2> <p>Agora que pelo menos o LED estava ligando, eu voltei o código para a funcionalidade normal, ou seja, inicializar a tela, renderizar o shell e ler o teclado.</p> <p>A tela começou a ser limpa como de costume mas parou no meio do caminho. Eu removi a rotina de limpeza de tela temporariamente e o prompt do shell apareceu na tela. Eu conseguia escrever mas depois de um curto intervalo a minha posição voltava para a inicial. Eu percebi que o Cardputer estava sendo resetado depois um intervalo preciso de tempo.</p> <p>Eu lembrei da documentação do <a class="reference external" href="https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/startup.html#second-stage-bootloader">procedimento de inicialização da aplicação</a> que o bootloader habilita o <a class="reference external" href="https://en.wikipedia.org/wiki/Watchdog_timer">watchdog</a>. E como agora o código da aplicação era totalmente providenciado por mim, eu tinha que cuidar disso eu mesmo: ou continuamente resetar o watchdog ou desabilitar ele.</p> <p>Eu escolhi disabilitar o watchdog por simplicidade (como sempre), e depois de ler a seção sobre watchdog do <a class="reference external" href="https://www.espressif.com/sites/default/files/documentation/esp32-s3_technical_reference_manual_en.pdf">manual do ESP32-S3</a> e adicionar algumas escritas de registradores ao código, estava feito: o sistema não resetava mais. Isso permitiu que o shell permanecesse na tela, mas ele estava cheio de lixo:</p> <img alt="{image}/bss.jpg" src="/images/cardos-without-arduino/bss.jpg" /> <p>Mais uma vez, lembrando da documentação do <a class="reference external" href="https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/startup.html#second-stage-bootloader">procedimento de inicialização da aplicação</a>, o código da aplicação (eu!) é o responsável por inicializar a seção <code class="docutils literal">.bss</code> para zero. Como essa seção contém as variáveis que devem ser inicializadas em zero, se eu não inicializar ela, todas essas variáveis vão conter lixo, que é o que eu estava vendo aqui.</p> <p>Eu não sabia um jeito bom de fazer isso, mas eu sabia como fazer com gambiarra: listar manualmente todas as variáveis globais em uma função e zerar elas 🙈. E foi isso que eu fiz e funcionou! (Nota: De lá para cá eu aprendi o jeito certo de fazer e limpei a gambiarra <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/a0030f679226ba4c9d296962968675d45dae2939">nesse commit</a>)</p> <p>E com isso o SO estava finalmente funcional e sem precisar do Arduino para compilar! E essa é a história completa por trás do commit &quot;<a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/85553f797cf0877e4c88a8e549052a445d00e7d1">Move from Arduino to generic C build flow</a>&quot;.</p> <p>Porém ainda tinha uma diferença de antes da mudança, ele estava muito mais lento. Isso é porque, pela última vez olhando na página de <a class="reference external" href="https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/startup.html#second-stage-bootloader">procedimento de inicialização da aplicação</a>, a aplicação que deve configurar a frequência do clock da CPU para o valor desejado. A frequência padrão é bem lenta, mas o código de inicialização implicitamente adicionado pelo Arduino configurava ela para um valor mais alto. Eu consertei isso em <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/2034cf7d5223fd242e8827a169218559366e9496">um commit subsequente</a>.</p> </div> <div class="section" id="outras-melhorias"> <h2>Outras melhorias</h2> <p>Com a remoção do Arduino feita, eu finalmente pude fazer algumas melhorias que eu queria há muito tempo.</p> <p>A primeira coisa que eu fiz foi separar o código-fonte que era em um único arquivo em vários arquivos diferentes <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/6c8dc5baa9ed1447b1e5083109b742f6eda68f32">nesse commit</a>. Eu estava muito ansioso para essa mudança e me senti muito bem em fazê-la 😌. Agora o código está muito mais organizado, é mais fácil encontrar as coisas e focar em um único componente.</p> <p>Eu também habilitei todos os principais warnings do compilador <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/f2dfd26dd05748ebef2312aedb8d88aeeda607b7">nesse commit</a>, incluindo um warning sobre fallthrough implícito em <em>case switches</em> que teria me salvo alguns minutos investigando um bug no começo desse projeto.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Esse foi mais um grande passo para o projeto. Eu me diverti bastante e aprendi muito.</p> <p>O próximo grande passo é implementar leitura e escrita no cartão SD e um sistema de arquivos. Provavelmente vai levar um bom tempo até eu acabar isso e voltar com uma atualização no blog. Fique à vontade para checar o <a class="reference external" href="https://codeberg.org/nfraprado/cardOS">repositório</a> para acompanhar as últimas atualizações no meio tempo se tiver curiosidade!</p> </div> CardOS: Escrevendo um SO para o Cardputer2024-05-25T00:00:00-03:002024-05-25T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2024-05-25:/pt-br/post/cardos-escrevendo-um-so-para-o-cardputer.html<p>Recentemente eu comprei um <a class="reference external" href="https://docs.m5stack.com/en/core/Cardputer">Cardputer da M5Stack</a>. O que me motivou foi que eu conhecia outras pessoas pessoalmente que também tinham ele, então eu teria com quem compartilhar o meu progresso, mas eu estava preocupado em acabar sendo só mais uma placa que ficaria guardada no meu armário para sempre …</p><p>Recentemente eu comprei um <a class="reference external" href="https://docs.m5stack.com/en/core/Cardputer">Cardputer da M5Stack</a>. O que me motivou foi que eu conhecia outras pessoas pessoalmente que também tinham ele, então eu teria com quem compartilhar o meu progresso, mas eu estava preocupado em acabar sendo só mais uma placa que ficaria guardada no meu armário para sempre sem ser tocada. De qualquer forma eu resolvi arriscar.</p> <p>Assim que eu peguei ele nas mãos, ele me conquistou. Ele tem tudo que é necessário para ser um computador: teclado completo para entrada, tela para saída, bateria para portabilidade, entrada de cartão microSD para armazenamento persistente, além de WiFi e Bluetooth para conectividade. O fato de ele ser um computador muito limitado, e tão minúsculo, só fez eu achar ele mais charmoso.</p> <p>Eu tenho muito interesse na idea de implementar um sistema completo do zero para entender todas as diferentes camadas e interações. Eu também sempre quis fazer o meu próprio sistema operacional (SO). Então antes de eu perceber, eu já tinha decidido em um objetivo: Eu iria fazer meu próprio SO do zero para o Cardputer.</p> <p>Mas quando eu digo do zero, eu não quero dizer necessariamente começar com um arquivo vazio, mas que eventualmente todo código tem que ter sido escrito por mim. Uma coisa que eu lembro dos vídeos do <a class="reference external" href="https://www.youtube.com/c/AndreasKling">Andreas Kling</a> (criador do SerenityOS) é que ele não começou a escrever o SO dele pelo bootloader, mas pela interface de usuário, e que isso o permitiu ver imediatamente o efeito das mudanças que ele fazia e trabalhar em pequenos passos em direção ao SO completo. Eu também lembro do <a class="reference external" href="https://en.wikipedia.org/wiki/Tarn_Adams">Tarn Adams</a> (co-criador do Dwarf Fortress) dando a mesma dica sobre como manter motivação no desenvolvimento de um jogo. E ambas são pessoas que eu admiro profundamente, então eu segui o conselho deles.</p> <p>Com isso em mente, eu comecei meu projeto a partir de <a class="reference external" href="https://github.com/m5stack/M5Cardputer/blob/master/examples/Basic/keyboard/inputText/inputText.ino">uma demo do Cardputer</a> que já tinha tela e teclado funcionais, e <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/8b1e75cfb9064f27d641296f06ff0fa89ac2dadc">eu escrevi um shell simples em cima dela</a>.</p> <p>Só depois disso que eu comecei a implementar meu próprio suporte ao teclado e à tela do zero e remover o código da demo.</p> <div class="section" id="fazendo-a-tela-funcionar"> <h2>Fazendo a tela funcionar</h2> <p>Implementar suporte para a tela foi muito mais complicado do que eu esperava e eu fiquei travado por um tempo. Nessa etapa eu já tinha implementado meu próprio suporte para o teclado, testado ele e ele tinha funcionado. Mas eu não conseguia fazer a tela nem mesmo acender, mesmo depois de ter lido o datasheet dela com cuidado várias vezes e implementado todo o procedimento de inicialização.</p> <p>Eventualmente eu dei um passo para trás e testei funcionalidades mais básicas e percebi que meu código para configurar GPIOs como saída não estava funcionando. Isso foi uma surpresa porque isso era necessário para o teclado, e eu já tinha testado ele. Mas o que eu não tinha percebido é que apesar de o meu código ser capaz de ligar e desligar pinos de saída para escanear o teclado, ele estava dependendo implicitamente do código de inicialização da demo para que os pinos de saída funcionassem, e por isso quando eu troquei todo esse código pela minha própria implementação da tela nem a tela nem o teclado funcionavam.</p> <p>Mas como muitas vezes é o caso em comportamentos inexplicáveis, esse não era o único problema. Para minha surpresa, o manual do ESP32 apresenta o endereço errado para um dos registradores necessários para configurar GPIOs. Por sorte ele também mostra o endereço correto em outra página, e eventualmente eu percebi essa diferença.</p> <p>Então depois que eu implementei o suporte para <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/5dda03f7af0d61af3ad2d81191a04d38ab7cc790">habilitar GPIOs de saída</a> e <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/0c380d6e9bb28816c5d55074d52bfca961696a2e">corrigi o endereço do registrador</a>, eu consegui <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/3095638dba5e6d40be7b592cfa52fb3835f35a83">consertar o suporte do teclado para ser completamente auto-contido</a>, e consegui finalmente, depois de muito suor, <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/commit/4706bea4bbdbc234c0054cd09c26a91a50865b5c">implementar o suporte para a tela</a> e remover a dependência a bibliotecas externas.</p> <p>Essa foi a maior conquista do projeto até agora e eu estou muito orgulhoso!</p> </div> <div class="section" id="estado-atual"> <h2>Estado atual</h2> <p>Esse é o estado atual do cardOS:</p> <object data="/images/cardos/cardos_demo.mp4" type="video/mp4">{image}/cardos_demo.mp4</object> <p>Em outras palavras, ele tem suporte a teclado e tela sem depender de bibliotecas externas. A comunicação com a tela é bem lenta, então tem bastante oportunidade para melhorias futuras 🙂. Ele tem um shell com alguns comandos, incluindo <code class="docutils literal">help</code> para mostrar os comandos, <code class="docutils literal">clear</code> para limpar a tela, <code class="docutils literal">read</code> para ler um endereço de memória arbitrário e <code class="docutils literal">led</code> para mudar a cor do LED RGB integrado. É possível navegar pelo histórico de comandos do shell e repetir comandos anteriores. E quando o terminal enche a tela ela é limpa automaticamente.</p> <p>Eu também passei um tempo consertando problemas. Nesse ponto o SO pareceu finalmente estar usável, então <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/releases/tag/v0.1">eu marquei ele</a> <code class="docutils literal">v0.1</code>.</p> </div> <div class="section" id="proximos-passos"> <h2>Próximos passos</h2> <p>A próxima coisa em que eu estou trabalhando é em parar de usar a toolchain do Arduino. O principal motivo é que ela adiciona código implicitamente ao binário quando usada, e eu quero continuar removendo dependências do meu código.</p> <p>Além disso, o Arduino basicamente força o uso de um único arquivo de código fonte. O fonte do cardOS é atualmente um único arquivo de 1900 linhas (sendo que 600 são <a class="reference external" href="https://codeberg.org/nfraprado/cardOS/src/commit/de836cdfa14bc63822665833ba27c57002b74f39/cardOS.ino#L1122">a estrutura contendo os caracteres da fonte</a>) e eu estou começando a me perder nele, então é uma boa hora para separar o código em múltiplos arquivos.</p> <p>Finalmente, o Arduino usa C++, e já que eu estou programando em C, essa mudança me permitiria usar um compilador de C, que fornece mensagens de erro melhores.</p> <p>Depois disso eu vou continuar trabalhando para fazer o cardOS ser um SO de verdade. Eu quero que ele passe a sensação de um computador hackeável, então minha meta é que seja possível abrir um editor de texto, editar um arquivo de inicialização de shell, salvar, reiniciar e ver os efeitos dessa mudança. Isso já me da trabalho suficiente: Eu preciso criar um editor de texto, uma linguagem de script de shell, e implementar suporte ao leitor de cartão microSD e a um sistema de arquivos.</p> <p>Mais no futuro eu estou bastante curioso sobre implementar suporte ao WiFi e quem sabe ser possível mandar e receber mensagens de IRC, se for possível. Tenho certeza que vai ser difícil, mas também vai ser divertido 😃.</p> <p>E é sobre isso: diversão! Fazem dois meses desde que eu comecei o projeto e eu posso dizer confiança que esse é o projeto em que eu mais me diverti de todos. Então enquanto ele continuar divertido eu vou continuar mexendo nele. Mas sem pressa para acabar, eu estou aproveitando a viagem 🙂.</p> </div> vCard + RSS como alternativa às redes sociais2024-03-22T00:00:00-03:002024-03-22T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2024-03-22:/pt-br/post/vcard-rss-como-alternativa-as-redes-sociais.html<p>Ano passado depois de conversar um pouco com alguém durante uma conferência, ele perguntou o meu LinkedIn para manter contato, e eu respondi que não tenho.</p> <p>Já fazem vários anos desde que eu decidi sair das redes sociais. Eu não sinto falta. Aplicativos de mensagem instantânea me permitem manter contato …</p><p>Ano passado depois de conversar um pouco com alguém durante uma conferência, ele perguntou o meu LinkedIn para manter contato, e eu respondi que não tenho.</p> <p>Já fazem vários anos desde que eu decidi sair das redes sociais. Eu não sinto falta. Aplicativos de mensagem instantânea me permitem manter contato com as pessoas que realmente são importantes para mim em um nível muito mais pessoal.</p> <p>Ainda assim, essa interação ficou na minha cabeça. De fato seria legal ter um registro dessas conexões também. As pessoas com quem você teve uma conversa interessante por alguns minutos. Poder checar como elas estão de vez em quando, onde estão trabalhando e no que estão hackeando.</p> <p>Basicamente eu gostaria que todo mundo tivesse um perfil online e um feed, que eu pudesse facilmente checar e seguir, e que os dados associados a eu estar seguindo pudessem ser armazenados localmente. Por que isso precisa ser exclusivo a redes sociais?</p> <p>Não é. Na verdade, a parte do feed já foi resolvido há muito tempo com o <a class="reference external" href="https://en.wikipedia.org/wiki/RSS">RSS</a>/<a class="reference external" href="https://en.wikipedia.org/wiki/Atom_(web_standard)">Atom</a>. Então só é necessário ter a URL do feed RSS/Atom de alguém, que você pode adicioná-la ao seu leitor de feed e facilmente seguir as atualizações de uma pessoa independente de onde elas são publicadas.</p> <p>A parte do perfil, um lugar com pontos chave sobre o estado atual de uma pessoa (nome, foto, localizaçäo, empresa, etc) é a que historicamente foi mais atrelada a redes sociais. Sites pessoais muitas vezes tem uma página &quot;sobre&quot; com essas informações, mas por conta da falta de estrutura eu não acho elas tão úteis quanto os perfis de redes sociais.</p> <p>Mas na verdade existe um padrão aberto amplamente usado para armazenar perfis também: <a class="reference external" href="https://en.wikipedia.org/wiki/VCard">vCard</a>. Ele é conhecido princpalmente como o formato usado por clientes de email para armazenar contatos, os quais são até sincronizados entre servidor e clientes usando o protocolo <a class="reference external" href="https://en.wikipedia.org/wiki/CardDAV">CardDAV</a>. Mas vCards também são usados para contatos no celular: é possível importar e exportar contatos no iOS e Android usando vCards.</p> <p>Então foi aí que eu percebi, se existe um padrão aberto amplamente usado para feeds, e outro para perfis, por que não juntar os dois? Ao colocar a URL de um feed RSS/Atom em um vCard, ele se torna um único arquivo com toda a informação necessária para identificar uma pessoa e acompanhar as atualizações dela. Por ser um único arquivo, é fácil de compartilhar com os outros e também de armazenar os vCards de todas as suas conexões localmente.</p> <p>Agora, um ponto interessante é que apesar da informação de perfil em um vCard poder ficar desatualizada, uma das propriedades disponíveis é a <code class="docutils literal">SOURCE</code> que tem como objetivo armazenar a URL de onde a última versão do vCard pode ser obtida. Ou seja, ao hospedar seu vCard em uma URL pública, por exemplo no seu site pessoal, é possível que pessoas que já baixaram ele o mantenham atualizado.</p> <p>Quanto a como a URL do feed pode ser incluída no vCard, depois de ler por cima a <a class="reference external" href="https://datatracker.ietf.org/doc/html/rfc6350">última versão da especificação</a>, eu originalmente tinha a intenção de que ela fosse uma propriedade <code class="docutils literal">URL</code> padrão. Mas eu queria que a URL principal do vCard ainda fosse a do site da pessoa, então algum mecanismo seria necessário para diferenciar entre as duas. Minha primeira ideia foi usar o parâmetro <code class="docutils literal">MEDIATYPE</code> na <code class="docutils literal">URL</code>, mas a especificação diz explicitamente que para protocolos como o HTTP o cabeçalho HTML <code class="docutils literal">Content-type</code> deveria ser usado para isso. Porém, aparentemente, apesar de feeds RSS/Atom terem <em>media type</em> próprios padronizados (<code class="docutils literal">application/rss+xml</code> e <code class="docutils literal">application/atom+xml</code> respectivamente), na prática, <code class="docutils literal">text/xml</code> é usado, o que não os identifica como feed. Então no fim, para conseguir determinar que uma URL em um vCard é de um feed, a URL teria que ser baixada e o arquivo lido. Para evitar essa complicação, eu decidi, relutantemente, usar uma propriedade não padronizada, <code class="docutils literal">X-FEED</code>, para o feed.</p> <div class="section" id="testando-na-pratica"> <h2>Testando na prática</h2> <p>Para conseguir testar a ideia na prática, eu criei <a class="reference external" href="https://codeberg.org/nfraprado/vcard-network">esse repositório</a> com dois scripts simples. O primeiro é o script <code class="docutils literal">vcard-render</code> que lê vCards e renderiza eles usando um template <a class="reference external" href="https://en.wikipedia.org/wiki/Jinja_(template_engine)">jinja</a>. A ideia é que você pode usá-lo para renderizar o seu vCard e o vCard de suas conexões no seu site, que é exatamente como eu estou usando ele <a class="reference external" href="https://nfraprado.net/br/pages/vcard-network.html">nesta página que eu adicionei ao meu site</a> (ela pode ser encontrada através da página Sobre). Para detalhes sobre como eu integrei o script no meu website, veja <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/148c9cf31eb10434ba127e94332e51397f18db99">este commit</a>.</p> <p>O outro script é o <code class="docutils literal">vcard-to-opml</code> que extrai feeds de vCards e gera um arquivo OPML com eles, o qual pode então ser importado em um leitor de feeds. A ideia é usar esse script nos vCards de todas as pessoas que você baixou (suas conexões) para que você possa facilmente seguir os feeds delas. Eu uso o leitor de feeds <a class="reference external" href="https://newsboat.org/">newsboat</a>, então eu adicionaria o seguinte comando em um crontab para rodá-lo periodicamente (assim que eu tiver algumas conexões de verdade!):</p> <pre class="code literal-block"> newsboat -i &lt;(awk 1 ~/ark/etc/dav/contacts/5DEB-65D21680-2F1-4AEA3480/* | ./vcard-to-opml.py) </pre> <p>Nota: <code class="docutils literal">awk</code> é usado aqui ao invés de um simples <code class="docutils literal">cat</code> porque aparentemente esses vCards não têm <code class="docutils literal">\n</code> no final do arquivo. Não sei se isso é culpa do meu provedor de email, onde eu guardo meus vCards, ou do <a class="reference external" href="http://vdirsyncer.pimutils.org/en/stable/">vdirsyncer</a>, que é o programa que eu uso para manter uma cópia local dos meus vCards.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Se você tiver interesse em experimentar usar vCards e RSS/Atom para conectar com pessoas também, dê uma olhada no <a class="reference external" href="https://codeberg.org/nfraprado/vcard-network">repositório</a>, que contém esses scripts. E fique à vontade para entrar em contato para me dizer que está usando, você pode achar meu email no... claro, no meu vCard 😉.</p> <p>Mesmo se ninguém usar isso, pelo menos agora eu tenho uma boa resposta para a próxima pessoa que pedir meu LinkedIn. &quot;Escaneie esse QR code e você vai ver meu perfil&quot; 🙂.</p> <img alt="{image}/qrcode_br.png" src="/images/vcard-network/qrcode_br.png" /> </div> Colecionando pins2023-11-23T00:00:00-03:002023-11-23T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2023-11-23:/pt-br/post/colecionando-pins.html<p>Começou inocentemente mais ou menos um ano atrás quando eu estava procurando um presente para um amigo. A gente jogou muito League of Legends e Ragnarok Online nos tempos de escola, então eu queria dar uma recordação disso para ele. Eventualmente eu encontrei esses pins:</p> <ul class="simple"> <li><a class="reference external" href="https://www.etsy.com/listing/587004849/poring-poporing-slime-monter-fanart-hard">Poring/Poporing do Ragnarok Online …</a></li></ul><p>Começou inocentemente mais ou menos um ano atrás quando eu estava procurando um presente para um amigo. A gente jogou muito League of Legends e Ragnarok Online nos tempos de escola, então eu queria dar uma recordação disso para ele. Eventualmente eu encontrei esses pins:</p> <ul class="simple"> <li><a class="reference external" href="https://www.etsy.com/listing/587004849/poring-poporing-slime-monter-fanart-hard">Poring/Poporing do Ragnarok Online</a></li> <li><a class="reference external" href="https://www.etsy.com/listing/1280961309/arcane-enamel-pin-fanmade-vis-hextech">Luva da Vi do League of Legends</a></li> </ul> <p>Eles eram exatamente o que eu estava procurando então eu comprei. Era para acabar aí, mas eu ainda sou muito fã do Ragnarok Online, e esses pins eram tão fofos que eu pensei, eu deveria comprar para mim também!</p> <p>Mas depois disso eu não conseguia mais parar de procurar por pins. Eu estava viciado! Eu continuei navegando no Etsy, pesquisando pins de jogos que eu gosto, e favoritando eles para que eu conseguisse encontrá-los depois.</p> <p>Eu também comecei a procurar pins em toda loja de souvenirs, que nunca tinham me chamado atenção, que eu passava. Agora eu realmente tinha algo de interessante para comprar! Então depois de algumas semanas eu já estava com uma pequena coleção:</p> <img alt="{image}/pins-before-pax.jpg" src="/images/pins/pins-before-pax.jpg" /> <p>Nessa época eu estava pensando em ir para a <a class="reference external" href="https://en.wikipedia.org/wiki/PAX_(event)">PAX east</a>. Quando eu descobri que o evento atraia uma grande comunidade de colecionadores de pin e contava com eventos de troca de pins, através <a class="reference external" href="https://www.youtube.com/watch?v=7hoSSI6A-_U">desse vídeo</a>, eu percebi que eu tinha que ir.</p> <p>Para conseguir levar meus pins convenientemente para a PAX, e trazer de volta os que eu conseguisse lá, eu comprei um <a class="reference external" href="https://www.amazon.com/dp/B07YYR3J1V/ref=cm_sw_r_as_gl_api_gl_i_NJTTQQ2YXTGC585NB7YN">PinFolio Classic</a>.</p> <p>No meu primeiro dia na PAX eu não me segurei e comprei todos os pins que eu gostei:</p> <img alt="{image}/pins-bought-1st-day-pax.jpg" src="/images/pins/pins-bought-1st-day-pax.jpg" /> <p>Depois de ter muita sorte e ganhar dois pins de fita cassete dourada em seguida de uma roleta, eu fui para a sala de troca de pins para trocar alguns pins e conhecer pessoas novas. Foi divertido reconhecer algumas das mesmas pessoas que apareceram no vídeo.</p> <p>Ao final da PAX, essa era minha coleção:</p> <img alt="{image}/pinfolio-after-pax.jpg" src="/images/pins/pinfolio-after-pax.jpg" /> <p>(o pin do Deviruchi está faltando porque estava preso na minha touca)</p> <p>Agora, muitos meses depois eu finalmente completei uma caixa com a minha coleção. Eu tenho mais alguns outrs pins, mas a minha intenção é usá-los para trocas em eventos futuros, então eles estão guardados no pinfolio. Então sem mais delongas, aqui está minha coleção, numerada:</p> <img alt="{image}/pins-full-labeled.jpg" src="/images/pins/pins-full-labeled.jpg" /> <ol class="arabic simple"> <li>Poring. Do Ragnarok Online. Feito por fã (Teaberryhouse). O primeiro da coleção! <a class="reference external" href="https://www.etsy.com/listing/587004849/poring-poporing-slime-monter-fanart-hard">Link</a></li> <li>Poporing. Veja 1.</li> <li><code class="docutils literal">/gg</code> Emote. Veio com 4.</li> <li>Deviruchi. Do Ragnarok Online. Feito por fã (FinniChang). Comprado junto com 1 e 2. <a class="reference external" href="https://www.etsy.com/listing/742804941/deviruchi-gg-ragnarok-online-enamel-pin">Link</a></li> <li>Eevee. Do Pokemon. Feito por fã (Jackalandhare). Eu estava comprando dois pins para um amigo que ama Pokemon e o terceiro era mais barato, então eu comprei um para mim também. <a class="reference external" href="https://www.etsy.com/listing/729815460/hard-enamel-pins-eeveelution-eevee?variation0=1222773687">Link</a></li> <li>Fairy bottle. Do Zelda. Feito por fã (FinniChang). <a class="reference external" href="https://www.etsy.com/listing/842366471/fairy-bottle-enamel-pin?variation0=1473891219">Link</a></li> <li>A Noite Estrelada de Van Gogh. Comprei enquanto visitava o Museu de Arte Moderna em NYC, onde eles mantêm o quadro real.</li> <li>Príncipe e Katamari. Do Katamari Damacy. Eu joguei Katamari Damacy Reroll ano passado e achei muito legal! E quem consegue resistir a um pin que gira? Comprado no stand da Fangamer na PAX. <a class="reference external" href="https://www.fangamer.com/collections/katamari-damacy/products/katamari-damacy-the-prince-katamari-spinning-pin">Link</a></li> <li>Rei. Veja 8. <a class="reference external" href="https://www.fangamer.com/collections/katamari-damacy/products/king-of-all-cosmos-pin-spinning">Link</a></li> <li>Corvinal. Do Harry Potter. Eu comprei em uma loja do Harry Potter no aeroporto de Londres, onde eu tinha uma conexão. Eu não ligo para Corvinal, mas era o pin mais bonito da loja.</li> <li>Junimos. Do Stardew Valley. Comprado no stand da Fangamer na PAX. <a class="reference external" href="https://www.fangamer.com/collections/stardew-valley/products/pinverse-junimos-pin-pack">Link</a></li> <li>Veio com 11.</li> <li>Babaa (Esse é o nome aparentemente!). Do Neopets. Eu joguei muito Neopets quando eu era mais novo, então quando vi esses pins disponíveis no stand da Geekify na PAX, eu tive que comprar.</li> <li>Pincel de Morango e Chocolate. Veja 13.</li> <li>Pincel de Espectro. Veja 13.</li> <li>Botão Fight. Do Undertale. Eu sou muito fã do Undertale como deve ter ficado óbvio pelas fotos anteriores. Comprado no stand da Fangamer na PAX. <a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-mercy-or-fight-enamel-pin-set">Link</a></li> <li>Botão Mercy. Veio com 16.</li> <li>Annoying dog. Veja 16. <a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-annoying-dog-lapel-pin">Link</a></li> <li>Máquina de Fliperama do Wonderville. Comprei enquanto visitava o <a class="reference external" href="https://www.wonderville.nyc/">Wonderville</a>, que é um lugar único e incrível, com um amigo.</li> <li>Psychokinetic Raz. Do Psychonauts 2. Eu ainda não joguei o jogo, só o primeiro, mas eu tinha acabado de terminar de assistir o <a class="reference external" href="https://www.youtube.com/watch?v=kRlI72bsNRc&amp;list=PLIhLvue17Sd70y34zh2erWWpMyOnh4UN_">documentário PsychOdyssey</a> que é incrível e então comprei esse pin como recordação. Comprado no stand da Fangamer na PAX. <a class="reference external" href="https://www.fangamer.com/products/raz-psychonauts-pin-spinning">Link</a></li> <li>Fantasma da Ópera. Comprei na saída do espetáculo do Fantasma da Ópera na Broadway. Foi muito bom!</li> <li>Canada Wilderness. Ganhei de um amigo. Ele comprou durante uma viagem nossa para Toronto (acho que na loja da torre).</li> <li>Loto. Ganhei de um amigo. É um pin antigo, diferente de todos os outros nessa coleção. Eu acho legal que ele tem números para cada um dos minúsculos quadradinhos.</li> <li>Frisk. Do Undertale. Comprado no stand da Fangamer na PAX. <a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-1">Link</a></li> <li>Toriel. Veio com 24.</li> <li>Sans. Veio com 24.</li> <li>Flowey. Veio com 24.</li> <li>Papyrus. Veja 24. <a class="reference external" href="https://www.fangamer.com/collections/undertale/products/undertale-character-pins-set-2">Link</a></li> <li>Undyne. Veio com 28.</li> <li>Alphys. Veio com 28.</li> <li>Mettaton. Veio com 28.</li> <li>Máscara. Do Mr Robot. Comprei usado da internet. É de uma Loot Crate de 2016. Queria muito que ele fosse menor.</li> <li>Logo da Software Freedom Conservancy. Ganhei de um amigo.</li> <li>Logo do L. Do Death Note. Comprei em uma loja geek em Antwerp.</li> <li>Anão. Do Dwarf Fortress. Um dos motivos de eu ter ido para a PAX foi para conhecer os criadores do jogo pessoalmente (e eu conheci!). Logo depois um pin de Dwarf Fortress foi anunciado e eu comprei online no mesmo dia. <a class="reference external" href="https://www.fangamer.com/products/dwarf-fortress-pin-finely-crafted">Link</a></li> <li>VHS PAX East. Comprado na PAX. As pessoas na PAX praticamente só trocam pins que sejam Pinny Arcade, então eu comprei esse como parte de um conjunto de 4 pins para começar minha coleção e poder trocar no evento.</li> <li>Logo da PAX East 2023. Veio com 36.</li> <li>Bloco de Minério de Diamante. Do Minecraft. Consegui esse trocando na PAX. Minecraft foi um dos jogos com maior impacto na minha vida, então eu fiquei muito feliz de conseguir ele.</li> <li>ATLAS e P-Body. Do Portal 2. Consegui ele trocando na PAX. Eu amo Portal, mas esse é o pin que eu menos gostei do <a class="reference external" href="https://pinnydb.com/pinDetail/271">set</a>, então eu quero tentar trocar ele por um dos outros na próxima PAX.</li> <li>Raz. Do Psychonauts. Eu ganhei esse de graça de uma pessoa na sala de trocas da PAX. Ela disse que já tinha muitos pins e já que eu estava começando minha coleção e gostei dele, eu podia ficar com ele 🙂.</li> <li>Bloco ?. Do Super Mario Bros. Comprado na PAX como parte de um conjunto de 4 para começar minha coleção Pinny Arcade e conseguir trocar. <a class="reference external" href="https://store.penny-arcade.com/collections/pins/products/super-mario-bros-1-1-pin-set">Link</a></li> <li>Mario. Veio com 41.</li> <li>Padrinhos mágicos. Eu assisti muuitas horas desse desenho no Jetix quando era criança. Até onde eu sei o único pin oficial, feito pelo Zen Monkey Studios. <a class="reference external" href="https://www.ebay.com/itm/234773032756">Link</a></li> <li>Trem de Paranaguá. Presente de um amigo que andou nesse trem. Agora eu preciso ir lá um dia usando esse pin 😃.</li> <li>Kerbal Space Program. Ganhei da mesma pessoa que 40.</li> <li>Green Flame. Da Acquisitions Inc. É uma campanha de RPG de mesa jogada ao vivo durante a PAX. Eu assisti na PAX e comprei esse pin de recordação. <a class="reference external" href="https://store.penny-arcade.com/collections/pins/products/green-flame-pin">Link</a></li> <li>Mae. Do Night in the Woods. Eu comprei ele na PAX antes de ter jogado o jogo. Eu simplesmente amei o estilo artístico. Provavelmente meu pin preferido.</li> <li>Los Andes. Ganhei de um amigo que visitou esse lugar, e ele adora escalar, então achei bem apropriado.</li> <li>Ganso. Do Kickstarter. Durante a PAX, o Kickstarter espalhou placas de ganso pelos stands de cada projeto financiado pelo Kickstarter. Se você encontrasse todos você ganhava um pin. Foi muito difícil mas eu consegui.</li> <li>Fita de ouro da PAX. Durante a PAX você podia pagar pins Pinny Arcade para girar uma roleta e ganhar a fita que caisse. Eu fui extremamente sortudo e consegui duas fitas de ouro seguidas. Eu troquei uma e fiquei com a outra.</li> <li>Azulejo. Comprei durante uma viagem para Portugal.</li> <li>Logo da Collabora. Ganhei durante o encontro da empresa. Infelizmente é magnético, então eu tenho medo de usar na rua e perder.</li> <li>Equador. Presente de um amigo que visitou esse lugar, o mesmo escalador que 48, percebeu o padrão? 😝</li> </ol> <p>Até então eu tenho guardado meus pins em uma caixa com tampa de vidro que fica em cima de uma mesa. Eu já pensei em deixar eles em um quadro na parede para que eles ficassem mais visíveis, mas fiquei preocupado de acabarem estragando com o tempo por estarem expostos o tempo todo.</p> <p>Mas eu também não deixo eles trancados na caixa permanentemente, porque isso seria um desperdício, então eu uso eles na roupa. Especificamente na touca, que é onde funciona melhor para mim (Veja a primeira foto). Por esse motivo eu não consigo usar pins durante o verão (ainda estou pensando em uma alternativa). Eu sempre uso um único pin porque acho que mais que isso fica bagunçado, e mudo frequentemente e tento combinar com a ocasião.</p> <p>Agora que essa caixa está cheia eu vou precisar comprar uma nova (ou talvez tentar um quadro dessa vez). Eu provavelmente vou publicar outro artigo quando esse encher também, mas isso provavelmente vai levar um tempo. Eu já tenho uma longa lista de pins para comprar, mas estou tentando maneirar. O foco é a qualidade e não a quantidade, e eu não quero chegar em um ponto onde não consigo apreciar cada um deles.</p> Encontrando com a comunidade Linux na minha primeira ELC2022-09-29T00:00:00-03:002022-09-29T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-09-29:/pt-br/post/encontrando-com-a-comunidade-linux-na-minha-primeira-elc.html<p>Esse mês eu participei da Embedded Linux Conference Europe, que ocorreu junto com a Open Source Summit Europe, em Dublin, na Irlanda. Essa foi minha primeira conferência de Linux presencial como contribuidor e foi uma experiência muito especial.</p> <p>Mas essa não foi minha primeira conferência de Linux presencial na vida …</p><p>Esse mês eu participei da Embedded Linux Conference Europe, que ocorreu junto com a Open Source Summit Europe, em Dublin, na Irlanda. Essa foi minha primeira conferência de Linux presencial como contribuidor e foi uma experiência muito especial.</p> <p>Mas essa não foi minha primeira conferência de Linux presencial na vida. Em 2018 eu participei da linuxdev-br, que ocorreu justamente na Unicamp, onde eu estava fazendo graduação. Eu me lembro de ter assistido a apresentação do Sergio Prado sobre como escrever um driver de LED e ter ficado fascinado com o fato de um LED físico poder ser ligado e desligado simplesmente escrevendo em um arquivo.</p> <p>Essa conferência foi um daqueles momentos que mudam sua vida dali para frente, já que foi lá que eu conheci a Helen Koike, que me convidou para participar dos encontros semanais do <a class="reference external" href="https://lkcamp.dev/">LKCAMP</a>, onde eles estavam ensinando sobre como o kernel funciona e ajudando as pessoas a submeterem seus primeiros <em>patches</em> e se tornarem contribuidoras. E depois de aprender bastante com eles e ter algumas contribuições aceitas eu eventualmente entrei na Collabora.</p> <p>De volta para 2022 e aqui estava eu em Dublin, para minha segunda conferência de Linux presencial na vida, dessa vez uma bem maior, e tendo trabalhado por mais de um ano na Collabora, participando como um contribuidor ativo do kernel Linux.</p> <p>Como um contribuidor, eu estou acostumado a interagir com outros desenvolvedores do kernel através das listas de email no dia-a-dia. E apesar de isso funcionar eficientemente para o projeto, é difícil se sentir conectado de uma forma humana com a comunidade lidando apenas com respostas em texto e endereços de email.</p> <p>E é por isso que encontrar com essas pessoas na vida real foi tão revigorante. É uma ótima mudança de ritmo poder conversar com elas de uma forma mais expressiva e humana, não apenas sobre trabalho mas sobre a vida no geral. E também de fato poder vê-las com meus próprios olhos e confirmar que são pessoas de verdade, com suas próprias vidas, aspirações, preferências de comida. Me lembrou que o mundo inteiro realmente é construido por pessoas como eu.</p> <p>Também foi minha primeira vez encontrando com meus colegas de trabalho da Collabora, o que foi espetacular! Foto <a class="reference external" href="https://twitter.com/Collabora/status/1570761841089073153">aqui</a>. Sou eu ali na esquerda 🙂.</p> <p>A Linux Foundation publicou o álbum de fotos do evento <a class="reference external" href="https://www.flickr.com/photos/linuxfoundation/albums/72177720301869820">aqui</a> caso queira ver.</p> <p>Eu mal voltei da viagem e já mal posso esperar pela próxima oportunidade de ver todo mundo de novo!</p> <img alt="{image}/convention-center-night.jpg" src="/images/elce/convention-center-night.jpg" /> <p>(O centro de convenções de Dublin iluminando a noite, do outro lado do rio Liffey)</p> Mudando o blog para o Codeberg2022-08-29T00:00:00-03:002022-08-29T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-08-29:/pt-br/post/mudando-o-blog-para-o-codeberg.html<p>Eu me importo bastante com FOSS, por isso sempre prefiro mudar para uma alternativa FOSS quando uma nova surge, desde que não haja grandes desvantagens.</p> <p>Na época da faculdade quando eu estava começando a usar o Git, eu só conhecia duas opções de serviços de Git: GitHub, o mais conhecido …</p><p>Eu me importo bastante com FOSS, por isso sempre prefiro mudar para uma alternativa FOSS quando uma nova surge, desde que não haja grandes desvantagens.</p> <p>Na época da faculdade quando eu estava começando a usar o Git, eu só conhecia duas opções de serviços de Git: GitHub, o mais conhecido mas proprietário, e o GitLab, menos conhecido mas mais aberto. Entre os dois, o GitLab era a escolha óbvia para os meus repositórios pessoais, incluindo esse blog.</p> <p>Alguns meses atrás eu conheci o <a class="reference external" href="https://codeberg.org/">Codeberg</a>. O Codeberg provê uma instância hospedada do <a class="reference external" href="https://gitea.io/">Gitea</a>, que é uma plataforma para repositórios Git completamente FOSS. Ainda por cima, o Codeberg é mantido por uma ONG, o que deixa claro que ele é focado na comunidade, e não no dinheiro. Do meu ponto de vista, não tem como ser melhor do que isso, então eu fiquei bastante motivado a mover todos meus repositórios para o Codeberg.</p> <p>A maioria dos meus repositórios são, na prática, simples backups: Eu sou o único enviando código para eles, e desde que o histórico de commits esteja disponível, eles não precisam de nenhuma outra funcionalidade. Por esse motivo a migração foi bem simples. A única exceção é o repositório do blog.</p> <div class="section" id="adaptacao-do-blog-para-o-codeberg"> <h2>Adaptação do blog para o Codeberg</h2> <p>A única grande funcionalidade faltante no Codeberg, e da qual eu dependia no GitLab para o blog, é a CI.</p> <p>Minha configuração atual do blog no GitLab era de ter um repositório com CI configurada para que toda vez que eu enviasse novas mudanças, a CI rodasse o pelican para gerar as páginas do site e servisse elas.</p> <p>No Codeberg, como não há CI, quaisquer arquivos que estiverem presentes no repositório especial <code class="docutils literal">pages</code> são servidos diretamente. Esse método exigiu que eu criasse dois repositórios: um para os arquivos fonte, o <a class="reference external" href="https://codeberg.org/nfraprado/blog">repositório blog</a>, e outro para a saída gerada ser servida, o <a class="reference external" href="https://codeberg.org/nfraprado/pages">repositório pages</a>.</p> <p><strong>Observação</strong>: <a class="reference external" href="https://codeberg.page/">Também é possível</a> usar um branch <code class="docutils literal">pages</code> no mesmo repositório, mas a opção do repositório separado me pareceu mais organizada.</p> <p>Mas claro que eu não queria gerenciar o repositório adicional <code class="docutils literal">pages</code>, já que isso seria irritante e rapidamente me faria sentir falta da CI do GitLab. Por isso eu adicionei um novo comando <code class="docutils literal">make deploy</code> no Makefile para automatizar o processo de publicar o site no repositório <code class="docutils literal">pages</code>. Ele pode ser visto <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/44bb31065898a942164a8a23c526d9363c750d93">nesse commit</a>.</p> <p>O que o <code class="docutils literal">make deploy</code> faz é:</p> <ul class="simple"> <li>Fazer os passos anteriormente feitos no <a class="reference external" href="https://codeberg.org/nfraprado/blog/src/commit/38cc4cfa0b5bb34eb5d088210abbce5cbf553ff7/.gitlab-ci.yml">.gitlab-ci.yml</a> para gerar os arquivos de saída do blog, especificamente:<ul> <li>Gerar as strings de tradução (através do <code class="docutils literal">make trans_deploy</code>)</li> <li>Gerar as páginas do site (através do <code class="docutils literal">make publish</code>)</li> </ul> </li> <li>Commitar os arquivos de saída e fazer push deles para o repositório <code class="docutils literal">pages</code></li> </ul> <p>Já que os arquivos de saída gerados pelo pelican precisam ser commitados e enviados para o repositório <code class="docutils literal">pages</code>, a pasta local de saída dentro da pasta do blog agora precisa ser um repositório git. Para permitir isso, a variável <code class="docutils literal">OUTPUT_RETENTION</code> <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/44bb31065898a942164a8a23c526d9363c750d93">precisou ser atualizada</a> para que o pelican não delete a pasta <code class="docutils literal">.git</code> toda vez que ele rodar.</p> <p>Em seguida eu melhorei as mensagens de commit para o repositório <code class="docutils literal">pages</code> através <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/38cc4cfa0b5bb34eb5d088210abbce5cbf553ff7">desse commit</a>, formatando elas com tanto o hash quanto a descrição, <a class="reference external" href="https://www.kernel.org/doc/html/latest/process/submitting-patches.html#describe-your-changes">no mesmo formato</a> que é usado para as tags <code class="docutils literal">Fixes:</code> no kernel Linux. Isso me permite não apenas correlacionar todo commit no repositório <code class="docutils literal">pages</code> ao commit correspondente no repositório <code class="docutils literal">blog</code>, mas também facilmente identificar sobre o que foram as últimas mudanças.</p> <p><a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/19f8d66f86038744362b6c9d23a33607e0b8ac84">Eu também adicionei</a> um arquivo <code class="docutils literal">.domains</code> à retenção já que ele é necessário para usar um domínio customizado com o Codeberg.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>No começo a necessidade de versionar os arquivos de saída com Git me pareceu desagradável, mas o fato de ser em um repositório separado e ser fácil relacionar os commits aos fontes fez com que isso deixasse de ser um problema para mim.</p> <p>Inclusive, eu percebi duas vantagens nessa estratégia do repositório <code class="docutils literal">pages</code> em relação a ter uma CI. Primeiro, eu não preciso mais pensar nas versões de imagens e pacotes que estão sendo usados na CI porque não há CI. Desde que meu sistema local seja capaz de gerar o blog, tudo continuará funcionando (e eu já precisava ter uma configuração local de toda forma para conseguir testar as mudanças antes de enviar). Segundo, assim que eu rodo <code class="docutils literal">make deploy</code> as mudanças são aplicadas instantaneamente no site, enquanto na CI do GitLab levariam em torno de um minuto para atualizar.</p> <p>Então foram necessárias algumas pequenas mudanças para ter uma boa configuração do blog no Codeberg mas eu estou feliz com a mudança. O Codeberg parece um ótimo novo lar e eu vou fazer questão de cuidar bem dele 🙂.</p> </div> Usando emojis no matplotlib2022-07-20T00:00:00-03:002022-07-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-07-20:/pt-br/post/usando-emojis-no-matplotlib.html<p>Mês passado, enquanto eu escrevia o artigo com todas as estatísticas para o aniversário de dois anos do blog, o <a class="reference external" href="/pt-br/post/estatisticas-do-blog-apos-dois-anos.html">artigo "Estatísticas do blog após dois anos"</a>, eu decidi que eu queria um gráfico com emojis. Assim que eu pensei nisso eu sabia que não iria funcionar de primeira e …</p><p>Mês passado, enquanto eu escrevia o artigo com todas as estatísticas para o aniversário de dois anos do blog, o <a class="reference external" href="/pt-br/post/estatisticas-do-blog-apos-dois-anos.html">artigo "Estatísticas do blog após dois anos"</a>, eu decidi que eu queria um gráfico com emojis. Assim que eu pensei nisso eu sabia que não iria funcionar de primeira e que eu estava me condenando a algumas horas investigando erros.</p> <p>Na primeira tentativa de gerar um gráfico com emojis, foi isso que saiu:</p> <img alt="{image}/emojis-traced.png" src="/images/matplotlib-emojis/emojis-traced.png" /> <p>Esses emojis só tem o contorno e alguns estão até faltando. Eu queria que o matplotlib usasse uma fonte própria para emoji, como a NotoColorEmoji ou twemoji, que são coloridas e bonitas. As duas estavam instaladas no meu sistema mas não estavam sendo detectadas automaticamente pelo matplotlib.</p> <p>Depois de pesquisar um pouco eu descobri como adicionar uma fonte explicitamente ao matplotlib:</p> <pre class="code python literal-block"> <span class="n">matplotlib</span><span class="o">.</span><span class="n">font_manager</span><span class="o">.</span><span class="n">fontManager</span><span class="o">.</span><span class="n">addfont</span><span class="p">(</span><span class="s2">&quot;/usr/share/fonts/noto/NotoColorEmoji.ttf&quot;</span><span class="p">)</span> </pre> <p>E eu também adicionei <code class="docutils literal">fontname=&quot;noto color emoji&quot;</code> à chamada do matplotlib que deveria renderizar usando essa fonte (no meu caso <code class="docutils literal">xticks()</code>).</p> <p>Forçando o matplotlib a usar a fonte de emoji que eu queria desse jeito realmente fez os emojis só com contorno pararem de aparecer, mas também fez a imagem inteira parar de aparecer 😝, agora a única coisa que eu tinha era traceback:</p> <pre class="code literal-block"> Traceback (most recent call last): File &quot;/home/nfraprado/emoji.py&quot;, line 3, in &lt;module&gt; matplotlib.font_manager.fontManager.addfont('/usr/share/fonts/noto/NotoColorEmoji.ttf') File &quot;/usr/lib/python3.10/site-packages/matplotlib/font_manager.py&quot;, line 1092, in addfont font = ft2font.FT2Font(path) RuntimeError: In FT2Font: Could not set the fontsize (error code 0x17) </pre> <p>Com código de erro até, me convidando a entrar mais fundo 😆. Como essa área de fontes não me era familiar, a primeira coisa a fazer era descobrir é o que é o FT2Font. <a class="reference external" href="https://github.com/matplotlib/matplotlib/blob/main/src/ft2font.cpp">Navegando no fonte</a> descobri que ele é o código do matplotlib responsável por lidar com o <a class="reference external" href="https://freetype.org/">FreeType</a>, a biblioteca que renderiza as fontes.</p> <p>A mensagem de erro do traceback estava vindo <a class="reference external" href="https://github.com/matplotlib/matplotlib/blob/60ae76b6b5b071e45d1ab652464f68a592cf977d/src/ft2font.cpp#L354">dessa linha</a>, o que significa que <code class="docutils literal">FT_Set_Char_Size()</code>, que é uma função do freetype, estava falhando com o código de erro <code class="docutils literal">0x17</code>. Uma checada na <a class="reference external" href="https://freetype.org/freetype2/docs/reference/ft2-error_code_values.html">referência de códigos de erro do freetype</a> mostrou que ele significava &quot;invalid pixel size&quot;.</p> <p>Enquanto eu tentava descobrir o que diferia as fontes de emoji de fontes normais, eu reparei em algo que parecia ser fundamental: Rodar <code class="docutils literal">fc-scan</code> nas fontes de emoji revelava que elas tinham uma propriedade <code class="docutils literal">pixelsize</code> que não estava presente em fontes normais. Além disso, rodar <code class="docutils literal">ftview</code> (do pacote <code class="docutils literal">freetype2-demos</code>) nas fontes de emoji passando qualquer tamanho resultava nos emojis sendo desenhados sempre do mesmo tamanho, enquanto fontes normais eram redimensionadas corretamente.</p> <p>A essa altura eu precisava realmente entrar no código, então eu clonei o fonte do matplotlib e do freetype, compilei, e configurei o ambiente para que eu conseguisse usá-los: instalei o matplotlib em um ambiente virtual com <code class="docutils literal">pip install -e .</code> e apontei a variável de ambiente <code class="docutils literal">LD_LIBRARY_PATH</code> para a pasta contendo os arquivos resultantes da compilação do freetype.</p> <p>Depois de habilitar os logs de debug no freetype (com <code class="docutils literal">FT2_DEBUG=any:5</code>) e adicionar alguns logs meus, eu percebi que a diferença no código que roda para as fontes de emoji é por conta de <code class="docutils literal">FT_HAS_FIXED_SIZES</code> ser verdadeiro, cujo significado pode ser visto <a class="reference external" href="https://gitlab.freedesktop.org/freetype/freetype/-/blob/e7482ff4c2a39e0e6bcf32b90ccfbfdd0f8ef5e6/include/freetype/freetype.h#L1372">aqui</a>.</p> <p>Então resumindo o problema (até onde eu entendo): as fontes de emoji são compostas por imagens embutidas, que possuem um tamanho específico. Isso é indicado com <code class="docutils literal">FT_HAS_FIXED_SIZES</code> sendo verdadeiro, e o tamanho dessas imagens aparece como o atributo <code class="docutils literal">pixelsize</code>. Quando o matplotlib vai desenhar a fonte, ele especifica o tamanho em que ele quer desenhar a fonte, mas já que a fonte de emoji tem um tamanho fixo, o código do freetype espera que o tamanho passado seja o mesmo tamanho da fonte. Isso porque você pode ter múltiplas versões das imagens, com diferentes tamanhos, dentro de uma mesma fonte, então o freetype iria escolher aquela que tem o tamanho que foi pedido.</p> <p>Com isso em mente, eu fiz essa modificação:</p> <pre class="code diff literal-block"> <span class="gh">diff --git a/src/base/ftobjs.c b/src/base/ftobjs.c</span><span class="w"> </span><span class="gh">index f66273f3d3cb..a59a61119702 100644</span><span class="w"> </span><span class="gd">--- a/src/base/ftobjs.c</span><span class="w"> </span><span class="gi">+++ b/src/base/ftobjs.c</span><span class="w"> </span><span class="gu">&#64;&#64; -3074,6 +3074,7 &#64;&#64;</span><span class="w"> </span> FT_Int i;<span class="w"> </span> FT_Long w, h;<span class="w"> </span><span class="gi">+ ignore_width = 1;</span><span class="w"> </span> if ( !FT_HAS_FIXED_SIZES( face ) )<span class="w"> </span> return FT_THROW( Invalid_Face_Handle );<span class="w"> </span><span class="gu">&#64;&#64; -3101,8 +3102,6 &#64;&#64;</span><span class="w"> </span> FT_Bitmap_Size* bsize = face-&gt;available_sizes + i;<span class="w"> </span><span class="gd">- if ( h != FT_PIX_ROUND( bsize-&gt;y_ppem ) )</span><span class="w"> </span><span class="gd">- continue;</span><span class="w"> </span> if ( w == FT_PIX_ROUND( bsize-&gt;x_ppem ) || ignore_width )<span class="w"> </span> { </pre> <p>O que essa mudança faz é forçar o freetype a retornar a primeira opção de imagem dentro da fonte, mesmo que ela não tenha o tamanho que foi pedido.</p> <p>Com isso feito, um outro erro passou a ocorrer, agora no matplotlib:</p> <pre class="code literal-block"> Traceback (most recent call last): File &quot;/home/nfraprado/emoji.py&quot;, line 3, in &lt;module&gt; matplotlib.font_manager.fontManager.addfont('/usr/share/fonts/noto/NotoColorEmoji.ttf') File &quot;/home/nfraprado/matplotlib/lib/matplotlib/font_manager.py&quot;, line 1134, in addfont prop = ttfFontProperty(font) File &quot;/home/nfraprado/matplotlib/lib/matplotlib/font_manager.py&quot;, line 545, in ttfFontProperty raise NotImplementedError(&quot;Non-scalable fonts are not supported&quot;) NotImplementedError: Non-scalable fonts are not supported </pre> <p>Então só agora o matplotlib estava reclamando que a fonte não é redimensionável, o que deveria ter sido o erro desde o início... Enfim, eu estava curioso para ver se isso tudo iria funcionar no fim, então eu simplesmente removi essa checagem:</p> <pre class="code diff literal-block"> <span class="gh">diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py</span><span class="w"> </span><span class="gh">index f57fc9c051b0..08d8c28752cb 100644</span><span class="w"> </span><span class="gd">--- a/lib/matplotlib/font_manager.py</span><span class="w"> </span><span class="gi">+++ b/lib/matplotlib/font_manager.py</span><span class="w"> </span><span class="gu">&#64;&#64; -541,8 +541,6 &#64;&#64; def ttfFontProperty(font):</span><span class="w"> </span> # Length value is an absolute font size, e.g., 12pt<span class="w"> </span> # Percentage values are in 'em's. Most robust specification.<span class="w"> </span><span class="gd">- if not font.scalable:</span><span class="w"> </span><span class="gd">- raise NotImplementedError(&quot;Non-scalable fonts are not supported&quot;)</span><span class="w"> </span> size = 'scalable'<span class="w"> </span> return FontEntry(font.fname, name, style, variant, weight, stretch, size) </pre> <p>E finalmente obtive alguma saída:</p> <img alt="{image}/emojis-bw-unscaled.png" src="/images/matplotlib-emojis/emojis-bw-unscaled.png" /> <p>Os emojis estão em preto e branco, e não estão do tamanho certo, mas é um avanço. Nessa hora, minha saída estava parecida com a que eu tinha visto em um <a class="reference external" href="https://towardsdatascience.com/how-i-got-matplotlib-to-plot-apple-color-emojis-c983767b39e0">artigo de blog</a> e <a class="reference external" href="https://github.com/matplotlib/matplotlib/issues/12830">issue no Github</a> linkada enquanto estava pesquisando. O problema nesse caso era o formato TTC, então não era a mesma coisa, mas a alternativa de usar um outro backend que tivesse um suporte melhor para emojis, <a class="reference external" href="https://github.com/matplotlib/mplcairo">mplcairo</a>, parecia promissora.</p> <p>Então eu instalei o mplcairo com o pip e fiz o script usar ele com</p> <pre class="code python literal-block"> <span class="n">matplotlib</span><span class="o">.</span><span class="n">use</span><span class="p">(</span><span class="s2">&quot;module://mplcairo.gtk&quot;</span><span class="p">)</span> </pre> <p>E essa foi a saída:</p> <img alt="{image}/emojis-colored-scaled.png" src="/images/matplotlib-emojis/emojis-colored-scaled.png" /> <p>Então os emojis realmente renderizaram coloridos e com o tamanho certo com esse backend! O único problema era que o texto no eixo Y estava rotacionado, mas uma busca rápida mostrou que <a class="reference external" href="https://github.com/matplotlib/mplcairo/issues/35">isso já estava consertado no repositório</a>, então eu reinstalei o mplcairo do git e tudo funcionou perfeitamente!</p> <p>Quando eu comecei a investigar esse problema eu pensei que fosse acabar enviando alguma modificação consertando a fonte, o freetype ou o matplotlib, mas com o meu entendimento atual, eu não tenho certeza qual seria a forma correta de consertar o problema. Eu precisaria investigar um pouco mais para saber, mas dado que eu consegui fazer funcionar para o meu uso, apesar de com algumas gambiarras, eu provavelmente não vou mais investigar esse problema por enquanto.</p> <p>Dito isso, o meu entendimento é que o mplcairo faz o redimensionamento da fonte por conta própria para fontes de tamanho fixo (emojis), então fazer o mplcairo checar os tamanhos disponíveis na fonte e passar para o freetype aquele que for mais próximo do tamanho que vai ser desenhado, poderia ser uma forma de se livrar da gambiarra no freetype. Já quanto à gambiarra no matplotlib, talvez fontes de tamanho fixo poderiam ser permitidas quando o o backend mplcairo estivesse sendo usado, já que ele claramente sabe lidar com elas. Mas, de novo, mais investigação necessária para concluir de fato.</p> <p>De qualquer forma, com essas duas gambiarras mostradas aqui e o backend mplcairo, eu consegui gerar o gráfico com os emojis mais frequentemente usados que está no final do <a class="reference external" href="/pt-br/post/estatisticas-do-blog-apos-dois-anos.html">artigo "Estatísticas do blog após dois anos"</a>. O script completo que gerou esse gráfico pode ser visto <a class="reference external" href="https://codeberg.org/nfraprado/blog/src/commit/f6c10780301d53661eff67052e180b9705d94610/extra/plot-top-emoji.py">aqui</a>.</p> <p>Por fim, para garantir a reprodutibilidade, vale mencionar que tudo isso foi testado com os pacotes nos seguintes commits:</p> <ul class="simple"> <li>mplcairo: <a class="reference external" href="https://github.com/matplotlib/mplcairo/commit/74c27c3dbd54c6c59fa0fd212d9c2bacd3275649">74c27c3dbd54</a> (&quot;Tweak path search in build-windows-wheel.&quot;)</li> <li>matplotlib: <a class="reference external" href="https://github.com/matplotlib/matplotlib/commit/60ae76b6b5b071e45d1ab652464f68a592cf977d">60ae76b6b5b0</a> (&quot;Merge pull request #23243 from timhoffm/take-over-22839&quot;)</li> <li>freetype: <a class="reference external" href="https://gitlab.freedesktop.org/freetype/freetype/-/commit/e7482ff4c2a39e0e6bcf32b90ccfbfdd0f8ef5e6">e7482ff4c2a3</a> (&quot;* src/lzw/ftzopen.c (ft_lzwstate_stack_grow): Cosmetic macro change.&quot;)</li> </ul> Estatísticas do blog após dois anos2022-06-20T00:00:00-03:002022-06-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-06-20:/pt-br/post/estatisticas-do-blog-apos-dois-anos.html<p>Uau, fazem dois anos desde que eu comecei esse blog! Estou muito feliz que consegui manter o ritmo de um artigo por mês pelo segundo ano. Espero que consiga manter pelo terceiro!</p> <p>Para esse artigo eu pensei que seria divertido ver algumas estatísticas sobre o que eu fiz no blog …</p><p>Uau, fazem dois anos desde que eu comecei esse blog! Estou muito feliz que consegui manter o ritmo de um artigo por mês pelo segundo ano. Espero que consiga manter pelo terceiro!</p> <p>Para esse artigo eu pensei que seria divertido ver algumas estatísticas sobre o que eu fiz no blog até agora. Para isso eu <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/c372aa64ce2049d42df0df4f908955905e89411b">criei um plugin 'stats'</a> para o pelican que gera as estatísticas em que estou interessado, e <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/f6c10780301d53661eff67052e180b9705d94610">escrevi scripts em python usando o matplotlib</a> para gerar gráficos dos dados coletados.</p> <div class="section" id="graficos-e-estatisticas"> <h2>Gráficos e estatísticas</h2> <p>Eu consegui manter o ritmo mensal de publicação, mas não consegui sempre publicar no dia 20 do mês como eu pretendia, e isso fica aparente nesse gráfico:</p> <img alt="{image}/dom-publish_br.png" src="/images/2years-stats/dom-publish_br.png" /> <p>(Abra a imagem em uma nova aba para ver melhor)</p> <p>No começo eu ainda não tinha decidido uma data para publicar todo mês, mas começando com o artigo de setembro de 2020 eu decidi que seria o dia 20 e consegui manter essa meta, quase sempre, até maio do ano seguinte. Depois disso eu praticamente nunca mais publiquei no dia 20, e existe até uma certa tendência ascendente a partir daí, com os artigos deslizando cada vez mais para o fim dos meses.</p> <p>Esse outro gráfico mostra a quantidade total acumulada em cada dia do mês:</p> <img alt="{image}/dom-publish-count_br.png" src="/images/2years-stats/dom-publish-count_br.png" /> <p>O dia 20 ainda é o dia em que eu mais publiquei, com 8 no total, mas a maior parte dos artigos estão distribuídos praticamente uniformemente nos dias após ele, totalizando 17! Ou seja, só um terço dos artigos, aproximadamente, foram de fato publicados no dia 20 como eu queria.</p> <p>Mas isso não me incomoda muito. Seria legal ter mantido a publicação dos artigos consistentes no mesmo dia do mês, mas publicar todo mês independente do dia é muito mais importante para mim, e eu estou bem feliz que tive sucesso nisso.</p> <p>Mudando um pouco de assunto, eu sempre quis saber a quantidade de palavras de cada artigo, então aqui está:</p> <img alt="{image}/word-count_br.png" src="/images/2years-stats/word-count_br.png" /> <p>Não existe nenhuma tendência óbvia, o que era de se esperar. O menor artigo de todos foi o <a class="reference external" href="/pt-br/post/configurando-o-mbsync-para-usar-xoauth2.html">artigo "Configurando o mbsync para usar XOAUTH2"</a> com 553 palavras em inglês e 567 palavras em português, enquanto o maior de todos foi o <a class="reference external" href="/pt-br/post/gerenciando-minhas-tarefas-usando-o-vit.html">artigo "Gerenciando minhas tarefas usando o VIT"</a> com surpreendentes 2727 palavras em inglês e 2747 palavras em português. O segundo maior artigo foi o <a class="reference external" href="/pt-br/post/domando-meu-kindle.html">artigo "Domando meu Kindle"</a> não muito abaixo, enquanto os demais ficaram todos abaixo das 2000 palavras.</p> <p>Esse gráfico também permite comparar a quantidade de palavras entre inglês e português, e fica claro que a versão em português é quase sempre um pouco maior. Isso confirma a minha percepção, já que várias vezes eu lembro de ter aumentado o tamanho da frase tentando expressar em português algo que em inglês eu consegui expressar com um único termo técnico comum.</p> <p>No total, todos os artigos em inglês somam 32718 palavras, enquanto todos os em português somam 33488 palavras. Logo, meus artigos em português são em média 2% maiores, o que honestamente é menos do que eu esperava.</p> <p>Importante mencionar que essa contagem de palavras é feita na etapa final de geração do artigo, quando ele já está em sua forma HTML, o que significa que todo o conteúdo que aparece nele após publicado está lá, com a diferença de que as tags HTML que poderiam adicionar à contagem são removidas. Na prática isso significa que a contagem total de palavras do artigo é o texto mais os blocos de código. Portanto um elemento importante que não aparece nesse gráfico são as imagens, que podem ser vistas a seguir:</p> <img alt="{image}/num-images_br.png" src="/images/2years-stats/num-images_br.png" /> <p>Nem todos os artigos tem imagens, mas alguns deles tem muitas delas! Inclusive, o <a class="reference external" href="/pt-br/post/domando-meu-kindle.html">artigo "Domando meu Kindle"</a>, que é o segundo maior artigo, é o que possui mais imagens, com 16 no total!</p> <p>Essa parte é bem arbitrária, mas eu queria levar em consideração o número de imagens na comparação de quantidade de conteúdo entre artigos. Eles dizem que uma imagem vale mais que mil palavras, mas no meu caso isso parece um pouco exagerado. Ao invés disso, contar cada imagem como 75 palavras, um parágrafo normal, parece mais razoável. Além disso, decidi fazer GIFs valerem três vezes mais, 225 palavras, já que o fato de serem animados os torna muito mais ricos. Com isso em mente, eu gerei um gráfico com a estimativa de conteúdo total de todos os artigos:</p> <img alt="{image}/total-content_br.png" src="/images/2years-stats/total-content_br.png" /> <p>Mais uma vez, os números são totalmente subjetivos, e isso ainda não leva em consideração os arquivos de áudio que eu compus e linkei no <a class="reference external" href="/pt-br/post/aprendendo-teoria-musical-escrevendo-melodias.html">artigo "Aprendendo teoria musical escrevendo melodias"</a>, nem os códigos que eu escrevi em algum repositório e que apenas linkei no blog, como no caso do <a class="reference external" href="/pt-br/post/gerenciando-meus-pacotes.html">artigo "Gerenciando meus pacotes"</a>. Mas dadas as limitações, eu diria que essa estimativa está muito mais próxima da minha percepção de quanto conteúdo cada artigo possui.</p> <p>Uma notável diferença é que nesse novo gráfico, o <a class="reference external" href="/pt-br/post/domando-meu-kindle.html">artigo "Domando meu Kindle"</a> se tornou o artigo com mais conteúdo.</p> <p>Enfim, de volta a métricas mais objetivas, eu gerei um gráfico com o número de links para outros artigos, ou referências cruzadas, que cada artigo possui:</p> <img alt="{image}/num-article-links_br.png" src="/images/2years-stats/num-article-links_br.png" /> <p>A maioria dos artigos não faz referência a outros (esperado), e os que fazem, são no máximo duas. Dito isso, este artigo apareceria muito mais alto do que o restante nesse gráfico, mas eu diria que ele é uma exceção, já que é um artigo instrospectivo sobre o blog.</p> <p>E links quaisquer?</p> <img alt="{image}/num-links_br.png" src="/images/2years-stats/num-links_br.png" /> <p>Todo artigo tem pelo menos um link, o que não é de se espantar, essa é a internet afinal de contas!</p> <p>E finalmente, a pergunta mais importante, quantos emojis??</p> <img alt="{image}/num-emojis_br.png" src="/images/2years-stats/num-emojis_br.png" /> <p>Não tão comuns quanto links (felizmente?), mas também nada mal. Aparentemente eu estou ficando mais consistente nos meus emojis, o que quer que isso signifique.</p> <p>Mas de que vale saber quantos emojis estão sendo usados se não pudermos ver quais?</p> <img alt="{image}/top-emoji_br.png" src="/images/2years-stats/top-emoji_br.png" /> <p>Claro que o sorriso é o mais comum, difícil não sorrir quando se está falando de algo em que está interessado. No segundo lugar temos o rosto com a língua para fora para os momentos engraçados. E mais alguns emojis aleatórios.</p> <p>Esse gráfico foi bem mais difícil de gerar do que parece, mas mais sobre ele no mês que vem (provavelmente).</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Apesar de ser necessário um certo esforço para conseguir escrever sobre algo todo mês, eu realmente gosto do resultado. Esse ritual mensal se mostrou terapêutico para mim, já que me dá a oportunidade de construir um novo tijolo nesse espaço seguro que é o meu blog, então eu sinto que estou avançando em algo na minha vida mesmo quando mais nada acontece.</p> <p>A necessidade de um artigo todo mês também me incentiva a continuar fazendo as coisas que me interessam, porque se não eu não vou ter sobre o que escrever!</p> </div> Descobrindo o conforto de alto-falantes2022-05-27T00:00:00-03:002022-05-27T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-05-27:/pt-br/post/descobrindo-o-conforto-de-alto-falantes.html<p>Em 2014, durante uma viagem escolar para a Alemanha, eu comprei um fone de ouvido Razer Tiamat. O som era ótimo e no geral era bem confortável. O único problema era que ele apertava bastante a cabeça e me dava dor de cabeça depois de longas horas de uso.</p> <p>Esse …</p><p>Em 2014, durante uma viagem escolar para a Alemanha, eu comprei um fone de ouvido Razer Tiamat. O som era ótimo e no geral era bem confortável. O único problema era que ele apertava bastante a cabeça e me dava dor de cabeça depois de longas horas de uso.</p> <p>Esse fone me serviu bastante e eu usei ele até 2021. A essa altura, o couro das almofadas já tinha desgastado quase completamente e o conector p2 quebrou e precisou soldar um novo duas vezes. Uma das vezes o contato de um dos fios não estava muito bom, o que fez com que um lado ficasse mais alto que o outro e precisou ser compensado em software, mas a compensação necessária mudava conforme o volume mudava, o que me deixou doido e eu lembro de ter ficado absurdamente feliz quando eu finalmente consertei isso.</p> <p>Então em 2021 já estava mais do que na hora de um novo fone. Já que a pressão na cabeça era o meu maior problema, eu queria achar um que apertasse o mínimo possível e que ainda tivesse um preço razoável.</p> <div class="section" id="a-procura-de-um-fone-confortavel"> <h2>À procura de um fone confortável</h2> <p>Pesquisando na internet eu encontrei um site chamado Rtings que analiza e classifica fones, e um dos critérios é o quanto ele aperta (<em>Clamping force</em>). Eu filtrei a lista por esse critério e decidi pegar o HyperX Cloud Alpha já que ele era um dos que menos apertava e não era muito caro.</p> <p>Mas quando ele chegou, eu fiquei bem decepcionado. Ele apertava muito mais do que o Tiamat e me dava dor de cabeça bem rápido depois de uma ou duas horas de uso. Eu tentei deixar ele esticando de um dia para o outro, mas não fez nenhuma diferença. Então eventualmente eu comecei a evitar a usar o fone e usar os alto-falantes embutidos do notebook, que soam muito mal, mas pelo menos não machucam.</p> <p>Alguns meses depois eu tinha me mudado para os EUA e tinha uma gama muito maior de opções à disposição, então eu decidi tentar de novo. Eu não queria errar uma segunda vez, então eu fiz questão de experimentar o maior número possível de fones em lojas físicas, e a B&amp;H era a maior que eu conhecia.</p> <p>Mas para minha surpresa, quase todos eles apertavam o suficiente para serem desconfortáveis para mim. Até o Bose QuietComfort 35, que pelas minhas pesquisas era um dos fones mais confortáveis, era um pouco apertado para mim. Mas eu achei sim alguns dos fones confortáveis, como o Sony Mdr7506, Phillips HP9500 e Koss UR20. E curioso que eles eram mais baratos que a maioria também. Mas esses fones eram tão soltos que parecia que iriam cair facilmente. Aparentemente eu não conseguia achar um meio termo para a pressão do fone.</p> <p>Nessa hora eu comecei a pensar que talvez meu problema era inerente a fones. Eu já tinha pensado em fones intra-auriculares também, mas o problema deles é que eles deformam dentro do seu ouvido, causando outro tipo de dor. Então de repente eu pensei em alto-falantes. Será que eles seriam a minha solução?</p> </div> <div class="section" id="procurando-um-bom-alto-falante"> <h2>Procurando um bom alto-falante</h2> <p>Pesquisando eu encontrei <a class="reference external" href="https://www.nytimes.com/wirecutter/reviews/best-computer-speakers/">um ranking de alto-falantes bem pesquisado e testado da Wirecutter</a>. Aparentemente essa é uma série bem conhecida de rankings, mas eu nunca tinha ouvido falar então fiquei feliz de encontrar.</p> <p>Eu cheguei bem perto de comprar um dos falantes mais recomendados deles, mas eu senti que seria mais importante ter um subwoofer do que a resposta em frequência ser plana como eles estavam priorizando, já que meu caso de uso é basicamente ouvir música, e não produzir.</p> <p>Eles tinham como &quot;Also great&quot; o Klipsch ProMedia 2.1 THX, que tem subwoofer. Pesquisando em outros rankings, eu percebi que apesar dos primeiros colocados serem diferentes, esse falante estava consistentemente aparecendo na maioria deles. E aparentemente ele é vendido já há uns bons anos, então se ele continua relevante nesses rankings, deve realmente ser bom.</p> <p>As desvantagens do Klipsch geralmente mencionavam a necessidade de espaço extra para o subwoofer espaçoso e a falta de conectividade com por exemplo bluetooth - a entrada de áudio é somente através de um cabo p2. Eu não vi nenhum problema quanto ao espaço: o subwoofer vai no chão, e lá eu tenho espaço de sobra! Quanto à entrada de áudio: eu ia deixar o falante conectado constantemente na porta &quot;Line Out&quot; da doca do meu notebook, então sem problemas também.</p> <p>Por fim, para ter uma ideia melhor do quão importante um subwoofer seria para mim, eu abri algumas músicas que eu gosto e que tem bastante grave no Audacity e usei o efeito &quot;Filter Curve&quot; e tentei imitar o gráfico de resposta em frequência que o artigo da Wirecutter mostrou para um dos falantes que não tinha subwoofer para ver como soaria. Isso se mostrou útil e ficou claro que sem as baixas frequências, essas músicas perderam bastante substância. Então eu concluí que realmente queria um subwoofer, e o Klipsch parecia ser o melhor falante com um, então eu escolhi ele.</p> </div> <div class="section" id="o-klipsch-promedia-2-1-thx"> <h2>O Klipsch ProMedia 2.1 THX</h2> <p>E olha... Essa deve ter sido uma das minhas compras mais felizes na vida. Primeiro de tudo, por causa da mudança de fone para alto-falante. Eu nem acredito que finalmente posso ouvir música <em>o dia inteiro</em> sem sentir <em>absolutamente nada</em> na minha cabeça. Isso é <em>mágico</em>.</p> <p>Segundo, o subwoofer realmente traz vida para a música. Não é <em>toda</em> música que faz uso dele, mas mais músicas do que eu pensei que seria. Dá para ouvir (e sentir!) ele principalmente no baixo e na percussão das músicas. O Klipsch tem um ajuste de volume separado para o subwoofer e eu fico diminuindo e aumentando ele para comparar a diferença que faz e realmente é impressionante.</p> <p>Quanto às desvantagens, o Klipsch tem um LED bem brilhante para mostrar que está ligado, mas não tem um botão para desligar, ou seja, esse LED fica sempre ligado. Mas um pedacinho de fita isolante em cima resolve o problema.</p> <p>Outra coisa é que agora que eu tenho um alto-falante tão bom preso na minha mesa, eu sinto falta dele quando levo meu notebook para um outro cômodo. Se tivesse um jeito de trazer ele comigo de uma forma portátil seria ótimo... Mas aí voltamos ao conceito de fone de ouvido e já sabemos onde esse caminho dá 😝. Eu também sinto um pouco de falta do isolamento sonoro (nos dois sentidos) de um fone, mas isso é bem menos importante do que conforto para mim.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Eu acho interessante que quando eu era criança, o computador na minha casa tinha um par de alto-falantes como era de costume. Mas desde então eu só tive, e vi outras pessoas usarem, fones de ouvido, então eu incoscientemente passei a considerá-los como a única opção. Perceber que esse não é o caso, apesar de alto-falantes hoje em dia aparentemente serem bem menos comuns, e voltar a usá-los é até poético de certa forma.</p> <p>Eu ainda tenho meu odiado fone de ouvido e eu uso ele para chamadas, já que o eco dos alto-falantes seria muito ruim. Mas assim que a chamada termina eu fico <em>muito</em> feliz em tirar o fone e voltar para o conforto dos meus alto-falantes 😌.</p> </div> Aprendendo com o SerenityOS2022-04-29T00:00:00-03:002022-04-29T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-04-29:/pt-br/post/aprendendo-com-o-serenityos.html<p>Um dia eu estava navegando pelo Reddit como de costume, quando eu vi uma postagem linkando para esse artigo: <a class="reference external" href="https://awesomekling.github.io/I-quit-my-job-to-focus-on-SerenityOS-full-time/">I quit my job to focus on SerenityOS full time</a>. Eu fiquei intrigado pela história, pela premissa desse SO, e também pelo fato do seu desenvolvimento estar sendo <a class="reference external" href="https://www.youtube.com/c/AndreasKling/videos">gravado no Youtube …</a></p><p>Um dia eu estava navegando pelo Reddit como de costume, quando eu vi uma postagem linkando para esse artigo: <a class="reference external" href="https://awesomekling.github.io/I-quit-my-job-to-focus-on-SerenityOS-full-time/">I quit my job to focus on SerenityOS full time</a>. Eu fiquei intrigado pela história, pela premissa desse SO, e também pelo fato do seu desenvolvimento estar sendo <a class="reference external" href="https://www.youtube.com/c/AndreasKling/videos">gravado no Youtube</a>.</p> <p>Agora, quase um ano depois, eu assisti quase todos os vídeos que o Andreas publicou no canal desde então e alguns dos mais antigos também. Os vídeos dele säo muito bons, eles são divertidos, inspiradores e eu aprendi muito com eles. E ele é uma pessoa muito boa também. O fato de um projeto tão positivo ter surgido da própria terapia dele é demais. Na minha opinião ele definitivamente achou seu propósito na vida e eu estou muito feliz por ele.</p> <p>O SerenityOS é um projeto extremamente interessante por si só. Ele contém código para o kernel, bibliotecas, serviços e aplicações, tudo em um único repositório. Ele te convida a se familizarizar com o sistema inteiro e ver como cada componente interage com os outros e se encaixa no todo. Além do mais existe uma variedade tão grande nos tipos de problemas que cada componente está tentando resolver que parece que sempre tem algo interessante para explorar no Serenity.</p> <p>Mas ter tudo no mesmo lugar não é útil só para aprender sobre o código. Quando você faz o sistema inteiro, é possível fazer algumas integrações muito legais. Algumas das minhas funcionalidades preferidas do Serenity são:</p> <ul class="simple"> <li>Todos os dados expostos pelo kernel através de arquivos no estilo procfs são no formato JSON!</li> <li>O aplicativo Profile Viewer não só é capaz de mostrar perfis de desempenho do sistema inteiro com as pilhas de execução em árvore como também até identificadores colocados pelas aplicações amostradas para demarcar eventos interessantes!</li> <li>Existe uma bela linguagem de marcação para descrever a GUI dos aplicativos, GML, e o aplicativo GML Playground mostra uma visualização em tempo real conforme você escreve!</li> <li>Em <em>todas</em> aplicações (a não ser que explicitamente desabilitado) é possível abrir uma paleta de comandos, com todos os comandos da aplicação.</li> </ul> <p>Outra vantagem em fazer o sistema inteiro é que mudar APIs é muito mais fácil, já que eles controlam ambos os lados. Isso permite iterar mais rapidamente e que melhores formas de fazer as coisas evoluam com o tempo sem haver necessidade de manter as iterações anteriores para manter a retrocompatibilidade. Dito isso, essa flexibilidade não se estende para a ABI e interações com o usuário. E apesar de até o momento essas também terem sido alteradas livremente, eu não sei o quanto disso é apenas devido ao SerenityOS ainda ser visto como em desenvolvimento e não haverem usuários de verdade. Mas talvez sendo um sistema &quot;por nós, para nós&quot; como diz o README, a habilidade de melhorar até mesmo na ABI pode ser vista como mais importante do que mantê-la estável. O tempo dirá.</p> <p>Quanto às minhas contribuições, até agora eu fiz apenas algumas, principalmente, <a class="reference external" href="https://github.com/SerenityOS/serenity/pull/12841">o suporte mais básico possível para mostrar capas de álbum no Sound Player</a> e <a class="reference external" href="https://github.com/SerenityOS/serenity/pull/12764">adição de suporte para múltiplos layouts de teclado no aplicativo Keyboard Settings</a>. Mas eu me diverti bastante trabalhando nelas, e estou ansioso para contribuir mais.</p> <p><strong>Atualização</strong>: no dia seguinte da publicação desse artigo a minha contribuição no Sound Player foi mostrada no <a class="reference external" href="https://youtu.be/yUmHEYs5n34?t=2105">vídeo de atualização do SerenityOS de Abril</a>! 😃</p> <p>Uma coisa que realmente me fez pensar foi o objetivo do Serenity de ter uma GUI no estilo de 1990. Quando eu comecei a usar e aprender sobre Linux alguns anos atrás, eu imediatamente fui atraído pelos programas CLI e TUI e preferi eles desde então. Eles representavam um paradigma bem diferente dos programas GUI que eu estava acostumado no mundo Windows. No terminal não havia medo de expor todas as funcionalidades de uma maneira bem flexível, existia muito mais espaço para customização e a performance tendia a ser melhor.</p> <p>Mas depois de ver a abordagem do Serenity, eu acho que meu desprezo por aplicações GUI tem sido equivocado. Com a mentalidade certa, programas GUI podem sim ser bastante flexíveis, customizáveis e ter boa performance. E além disso podem ter uma aparência consistente e estética agradável. O que mais você quer de um software? Em resumo, eu agora estou confiante de que eu prefiriria usar GUIs para a maioria das tarefas, é só que as que estão por aí não tendem a focar nas coisas certas para mim.</p> <p>O SerenityOS ainda passa a sensação de um brinquedo. E é bem divertido brincar com ele. Mas eu também concordo com muitos dos seus objetivos, e ele está crescendo muito rápido, portanto é um SO bem promissor para mim. Por um lado, eu gostaria que ele já estivesse pronto para o uso cotidiano para que eu pudesse mudar para ele logo, mas por outro, isso tiraria toda a diversão de chegar lá (tanto em contribuir eu mesmo quanto assistir aos vídeos do Andreas!). Fora que é mais fácil contribuir quando ainda tem bastante coisa para fazer 🙂.</p> Rodando LineageOS no meu Nexus 5X2022-03-30T00:00:00-03:002022-03-30T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-03-30:/pt-br/post/rodando-lineageos-no-meu-nexus-5x.html<p>Esse mês completa um ano desde que eu comprei um Nexus 5X e comecei a usar LineageOS, então parece um bom momento para compartilhar minha experiência.</p> <div class="section" id="compra-e-instalacao"> <h2>Compra e instalação</h2> <p>Aproximadamente um ano atrás, <a class="reference external" href="https://andrealmeid.com/">um amigo</a> me disse que tinha achado uma oferta muito boa para um Nexus 5X online. O …</p></div><p>Esse mês completa um ano desde que eu comprei um Nexus 5X e comecei a usar LineageOS, então parece um bom momento para compartilhar minha experiência.</p> <div class="section" id="compra-e-instalacao"> <h2>Compra e instalação</h2> <p>Aproximadamente um ano atrás, <a class="reference external" href="https://andrealmeid.com/">um amigo</a> me disse que tinha achado uma oferta muito boa para um Nexus 5X online. O Nexus 5X já é um celular antigo, lançado em 2015, e por isso tende a ser bem barato, apesar de ainda ser um celular bem decente mesmo para os padrões atuais. A oferta que ele encontrou era para um Nexus 5X <em>novo</em>, que vinha dentro da caixa original, perfeitamente conservado, e ainda sim custava apenas R$ 300. Um ótimo negócio.</p> <p>Nesse ponto eu já estava usando Linux no meu computador há vários anos, mas meu celular, possivelmente a máquina que tem acesso à maior quantidade de informações pessoais, ainda estava rodando Android, que é um SO que não é completamente FOSS, e isso me incomodava bastante.</p> <p>Eu já tinha tido vontade de mudar para o LineageOS, a alternativa FOSS ao Android, há algum tempo, mas como era meu único celular parecia muito arriscado. Com a possibilidade de ter um novo Nexus 5X de repente eu vi a oportunidade de ter um celular bem testado (e amado) com LineageOS, e se tudo desse errado, meu celular antigo ainda estaria lá com tudo exatamente do mesmo jeito. Então eu decidi pegar um Nexus para mim também.</p> <p>Eu segui o <a class="reference external" href="https://andrealmeid.com/post/2020-11-23-bullhead-los/">guia de Nexus 5X do meu amigo</a> e tive um pouco de ajuda pessoal dele para entender os componentes de software necessários para rodar uma instalação de LineageOS totalmente sem Google. No meu caso o celular era novo, então eu pude usar uma imagem sem o patch de BLOD e ter acesso à performance total do Nexus 5X.</p> <p>A instalação em si foi fácil de seguir (tudo bem que eu tinha acesso a um guia e um mentor). E ao final eu tinha meu próprio celular com LineageOS, MicroG e Magisk, completamente sem Google e ainda sim capaz de instalar software que dependesse do Google Services quando necessário.</p> </div> <div class="section" id="problemas"> <h2>Problemas</h2> <p>No geral a experiência é ótima, mas tem dois problemas principais:</p> <ul class="simple"> <li><strong>Problemas frequentes na câmera</strong>: Basicamente toda vez que eu abro a câmera, ela fecha na primeira vez, e eu preciso abrir de novo e aí ela funciona. Irritante, mas ainda não o suficiente para eu ir tentar consertar.</li> <li><strong>Suporte de GPS errático</strong>: O GPS foi a coisa mais difícil de fazer funcionar. Eu lembro de ter visto algumas pistas <a class="reference external" href="https://blog.eowyn.net/unifiednlp/">nesse artigo</a>, e finalmente consegui fazer funcionar simplesmente habilitando os módulos de localização &quot;Mozilla Location Service&quot; e &quot;WiFi Location Service&quot;, mas nem sempre funcionava e demorava um tempo inicial antes de começar a funcionar. E aí eu mudei de país e agora não consigo mais fazer funcionar...</li> </ul> <p>Mas esses são problemas de software que podem eventualmente ser consertados. Tem uma única limitação de hardware no Nexus 5X que me deixou decepcionado assim que eu notei: <strong>Ele só tem 16GB de armazenamento interno e não tem entrada para cartão SD</strong>.</p> <p>Para os aplicativos, 16GB na verdade é até ok, mas para tirar fotos ou vídeos e armazenar música, não era o suficiente.</p> <div class="section" id="procurando-por-mais-espaco"> <h3>Procurando por mais espaço</h3> <p>Mas eu não desisti logo de cara. O celular estava tão perto de ser perfeito, eu precisava achar um jeito de contornar a falta de espaço de armazenamento.</p> <p>O Nexus 5X tem uma porta USB-C OTG, então eu percebi que poderia comprar um pendrive USB-C, o menor possível para que não fosse muito intrusivo, para efetivamente expandir o espaço de armazenamento.</p> <p>Depois de pesquisar um pouco, o pendrive USB-C mais compacto que eu encontrei foi o <a class="reference external" href="https://www.amazon.com/Kingston-Digital-32GB-Traveler-DTDUO3C/dp/B01M59PHE4">Kingston DTDUO3C/128GB</a>. Então foi ele que eu comprei. Logo que ele chegou eu notei que ele vinha com uma cordinha para chaveiro e a capa do meu celular tinha uma cavidade para isso, então eu amarrei ele lá e achei que ficou bonitinho. Dito isso tem algumas desvantagens: o pendrive as vezes engacha no meu bolso, e também bate na tela. Ficou assim:</p> <img alt="{image}/usb_disconnected.jpg" src="/images/nexus5x/usb_disconnected.jpg" /> <img alt="{image}/usb_connected.jpg" src="/images/nexus5x/usb_connected.jpg" /> <p>Mas assim que eu inseri o pendrive eu fiquei desapontado ao ver que o tocador de música não reconhecia nenhuma música que estava lá. Aparentemente o pendrive estava funcionando apenas como um simples armazenamento e eu só conseguia mover arquivos de/para ele usando o gerenciador de arquivos.</p> <p>Mas como isso era um problema estranho, eu pensei que deveria ter um jeito de contorná-lo. Afinal, era só uma limitação arbitrária imposta pelo Android. Depois de um pouco de pesquisa, de fato, <a class="reference external" href="https://forum.xda-developers.com/t/enable-apps-to-read-otg-usb-contents-in-marshmallow-nougat.3539389/">um artigo no fórum do XDA veio para o resgate</a> com uma solução de praticamente uma linha:</p> <div class="highlight"><pre><span></span>su sm<span class="w"> </span>set-force-adoptable<span class="w"> </span><span class="nb">true</span> </pre></div> <p>E só com isso, reinserindo o pendrive fez o tocador de música rapidamente começar a indexar todos os arquivos de música que ele tinha acabado de encontrar no pendrive. Funcionou!</p> <p>Mas tem um grande porém: eu preciso sempre lembrar de inserir o pendrive antes de abrir o tocador de música, e fechar ele antes de remover o pendrive. Caso contrário o tocador não enxerga mais nenhuma música no dispositivo, e na próxima vez que eu inserir o pendrive, ele demora alguns minutos indexando todos os arquivos de novo (e travando algumas vezes durante o processo).</p> <p>Dado que eu precisava que meus arquivos de música (e possivelmente fotos) fossem sincronizados com o computador, eu também estava interessado em fazer o Syncthing funcionar com pastas no pendrive.</p> <p>Para a minha surpresa isso não funcionou de primeira: O Syncthing só tem permissão de leitura em armazenamentos externos. Mas eu logo descobri que dando permissão de root para ele remove essa limitação, e isso pode ser feito pelo Magisk. Não é a solução ideal, mas pelo menos com isso eu tenho uma configuração funcional para sincronizar e tocar músicas no celular!</p> <p>Eu também estava curioso para ver se eu conseguiria fazer a câmera salvar fotos e vídeos diretamente no pendrive. Isso resolveria a maior parte do problema de pouco espaço no celular.</p> <p>Para não alterar as configurações do aplicativo de câmera principal, eu baixei o aplicativo Simple Camera e configurei ele para salvar em uma pasta no pendrive. Para minha surpresa ele simplesmente pediu permissão de escrita para o pendrive, e não precisou ser rodado como root como o Syncthing.</p> <p>Então eu tentei gravar um vídeo com ele. Na primeira tentativa ele deu um erro e pediu para escolher a qualidade de imagem e eu abaixei para 1080p. Eu acho que a velocidade de escrita do USB não era rápida o suficiente para a resolução original da câmera.</p> <p>Com isso feito, eu consegui tirar fotos e vídeos. Logo depois que eu paro a gravação do vídeo o aplicativo fecha, mas o arquivo parece ser corretamente escrito no pendrive e sincronizado com o computador.</p> <p>Mas no fim até o momento eu tenho evitado usar o pendrive para a câmera (usando o aplicativo de câmera original), porque, diferentemente de música, tirar fotos/vídeos é situacional, e eu não quero arriscar que minhas fotos falhem ao salvar ou precisem de múltiplas tentativas (já basta o aplicativo travando...). De qualquer forma é bom saber que ele fuciona, até certo ponto, para quando eu quiser usar a câmera e o armazenamento interno estiver cheio.</p> <div class="section" id="pendrive-como-armazenamento-interno"> <h4>Pendrive como armazenamento interno</h4> <p>Mas algo mais aconteceu quando eu habilitei a configuração <code class="docutils literal">force-adoptable</code>. Navegando nas configurações, aparentemente que agora eu podia formatar o pendrive como um armazenamento interno. Isso faria com que a memória do pendrive fosse usada transparentemente, até para armazenar os aplicativos instalados. Mas uma pergunta veio à mente: &quot;O que aconteceria quando eu removesse o pendrive?&quot;. Só tinha um jeito de descobrir se isso seria usável ou não...</p> <p>Levou em torno de 30 minutos para o pendrive ser formatado e a maioria dos dados do armazenamento interno ser movido para ele. Mas no final eu tinha extendido o armazenamento do meu celular em 128GB com sucesso. E a sensação foi de... muita lentidão. O sistema inteiro ficava dando travadas o tempo todo. Pelo visto a velocidade do pendrive é muito mais lenta do que a do armazenamento interno. E agora que o sistema dependia dessas transferências isso ficava bem aparente.</p> <p>Mas talvez eu conseguisse viver com um celular lento em troca de mais espaço de armazenamento, né? E a grande pergunta: o que acontece quando o pendrive é removido? Isso é muito importante de saber já que eu precisaria removê-lo no mínimo para carregar uma vez por dia. E a resposta é: ele não gosta nem um pouco disso. O sistema reinicia 😝.</p> <p>Eu passei quase três dias assim: Com um celular com um armazenamento gigante de 128GB, mas que era lento e reiniciava toda vez que eu precisava recarregá-lo (o que também acontecia mais frequentemente já que o pendrive aparentemente consome bastante bateria).</p> <p>No final desses três dias eu já estava cansado disso e então reformatei o pendrive como armazenamento externo e voltei para a configuração anterior. Foi um experimento interessando (apesar de frustrante).</p> </div> </div> </div> <div class="section" id="recomendacoes-de-aplicativos"> <h2>Recomendações de aplicativos</h2> <p>Em questão de aplicativos, eu tento o máximo possível usar aplicativos da loja <a class="reference external" href="https://f-droid.org/">F-Droid</a>, mas tem alguns aplicativos que eu ainda preciso usar da PlayStore. Felizmente, o aplicativo AuroraStore, que já vem instalado, pelo menos fornece uma alternativa privativa à PlayStore.</p> <p>Dos aplicativos que eu instalei da F-Droid, esses são os que eu realmente gosto:</p> <ul class="simple"> <li><a class="reference external" href="https://f-droid.org/en/packages/de.danoeh.antennapod">AntennaPod</a>: Tocador de podcast.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.google.android.diskusage">DiskUsage</a>: Visualizador de uso de espaço de armazenamento.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/eu.depau.etchdroid">EtchDroid</a>: Criador de imagem USB. Eu falei sobre ele no <a class="reference external" href="/pt-br/post/revivendo-um-computador-no-meio-do-nada.html">artigo "Revivendo um computador no meio do nada"</a>.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/ml.docilealligator.infinityforreddit">Infinity</a>: Visualizador do Reddit.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.kunzisoft.keepass.libre">KeePassDX</a>: Gerenciador de senhas.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/net.mullvad.mullvadvpn">Mullvad</a>: Cliente VPN.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/org.schabi.newpipe">NewPipe</a>: Visualizador do YouTube.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/net.osmand.plus/">OsmAnd~</a>: Visualizador de mapa offline baseado no OpenStreetMap.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.spicychair.weather">Pluvia</a>: Visualizador de previsão do tempo.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/name.boyle.chris.sgtpuzzles/">Puzzles</a>: Uma coleção de bons jogos de puzzle.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.nutomic.syncthingandroid">Syncthing</a>: Sincronizador de arquivos.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.termux">Termux</a>: Terminal.</li> <li><a class="reference external" href="https://f-droid.org/en/packages/com.poupa.vinylmusicplayer">Vinyl</a>: Tocador de música.</li> </ul> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Eu não sei por quanto tempo vou continuar usando esse celular, mas eu com certeza não volto mais para o Android. Eu vou ou continuar com o LineageOS or talvez me aventurar no PostmarketOS, se a experiência de usuário estiver num nível bem usável até lá (ou não se eu sentir que de repente tenho bastante tempo livre 😝). De qualquer forma eu vou garantir que meu próximo celular tenha mais espaço de armazenamento 🙂.</p> </div> Aprendendo o básico de assembly x86-642022-02-25T00:00:00-03:002022-02-25T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-02-25:/pt-br/post/aprendendo-o-basico-de-assembly-x86-64.html<p>Recentemente eu decidi aprender assembly. Eu já tinha um entendimento razoável de como funciona graças a algumas aulas que tocavam no assunto na universidade, mas eu nunca tive a oportunidade de realmente escrever código em assembly.</p> <p>Já que meu computador é uma máquina x86-64, eu decidi aprender assembly para essa …</p><p>Recentemente eu decidi aprender assembly. Eu já tinha um entendimento razoável de como funciona graças a algumas aulas que tocavam no assunto na universidade, mas eu nunca tive a oportunidade de realmente escrever código em assembly.</p> <p>Já que meu computador é uma máquina x86-64, eu decidi aprender assembly para essa arquitetura, assim eu não precisaria de uma máquina virtual. Eu comecei com apenas o desejo de botar a mão na massa com código em assembly, sem ter nenhum objetivo ou projeto em especial.</p> <p>No começo eu estava alternando entre tentar coisas e pesquisar na internet só para entender o suficiente a ponto de conseguir fazer um arquivo mínimo em assembly que eu conseguisse montar e rodar. Eventualmente eu encontrei o livro que me guiaria: <a class="reference external" href="https://open.umn.edu/opentextbooks/textbooks/733">x86-64 Assembly Language Programming with Ubuntu</a>.</p> <p>Esse livro é grátis, recente e tinha o escopo perfeito para mim: é voltado para pessoas que já entendem bem de programação, mas que são novas em assembly x86-64, e ele expõe um pouco de teoria e conceitos, mas também tem bastante exercícios para aprender praticando.</p> <p>Foi bem divertido completar esse livro, e funcionou muito bem para eu criar mais familiaridade com assembly x86-64. Com certeza ainda tem muito para eu aprender sobre o assunto, já que o livro apenas dá a base, mas já foi o suficiente para me ensinar algumas coisas interessantes.</p> <div class="section" id="sinal-de-variaveis-e-complemento-de-dois"> <h2>Sinal de variáveis e complemento de dois</h2> <p>A maior lição para mim foi um melhor entendimento sobre o sinal de variáveis. Eu estou acostumado a ver <code class="docutils literal">int</code> e <code class="docutils literal">unsigned int</code> em C, e a tomar cuidado para usar o correto, mas não era claro para mim como isso funcionava no nível do assembly.</p> <p>A primeira coisa a se ter em mente, é que o conceito de tipos presente em linguagens de alto nível como C (por exemplo se um número é com ou sem sinal) é completamente ausente no assembly. A memória do computador armazena apenas 0s e 1s, e cabe a você, que está programando, interpretar o que eles significam: <code class="docutils literal">01011000</code> é o número 88, o caractere <code class="docutils literal">X</code>, a instrução <code class="docutils literal">POP AX</code>? Tendo apenas o byte, você não consegue nem ter certeza do tamanho: talvez seja na verdade 8 flags booleanas em um único byte, ou parte de um número de 4 bytes. Sem ter o contexto, é impossível dizer.</p> <p>Se a mesma representação pode significar tanto um número com sinal quanto um sem sinal, dependendo do contexto, isso significa que quando estiver fazendo operações com esses números, você que está programando que precisa usar a variante correta da instrução para fornecer esse contexto para o computador.</p> <p>Durante o livro, as instruções aritméticas a seguir foram apresentadas para números sem sinal:</p> <ul class="simple"> <li><code class="docutils literal">add</code> soma dois números</li> <li><code class="docutils literal">sub</code> subtrai dois números</li> <li><code class="docutils literal">mul</code> multiplica dois números</li> <li><code class="docutils literal">div</code> divide dois números</li> </ul> <p>E as instruções a seguir foram mostradas para comparação entre números sem sinal:</p> <ul class="simple"> <li><code class="docutils literal">ja</code> compara dois números e pula se o primeiro for maior que o segundo</li> <li><code class="docutils literal">jb</code> compara dois números e pula se o primeiro for menor que o segundo</li> </ul> <p>E claro, logo em seguida, as variantes dessas instruções para números com sinal também foram mostradas:</p> <ul class="simple"> <li><code class="docutils literal">imul</code> é a variante com sinal do <code class="docutils literal">mul</code></li> <li><code class="docutils literal">idiv</code> é a variante com sinal do <code class="docutils literal">div</code></li> <li><code class="docutils literal">jg</code> é a variante com sinal do <code class="docutils literal">ja</code></li> <li><code class="docutils literal">jl</code> é a variante com sinal do <code class="docutils literal">jb</code></li> </ul> <p>Mas calma, e o <code class="docutils literal">iadd</code> e o <code class="docutils literal">isub</code>? É aí que tá, o jeito que o x86-64 representa números negativos é usando o sistema de <a class="reference external" href="https://pt.wikipedia.org/wiki/Complemento_para_dois">complemento de dois</a>, que tem a útil propriedade de possibilitar que somas e subtrações sejam feitas exatamente da mesma forma tanto para números com sinal quanto para sem sinal.</p> <p>Isso significa que só existe uma forma de somar, independente do sinal do número, e é usando <code class="docutils literal">add</code>. Não existe <code class="docutils literal">iadd</code>. Mesma coisa para subtração.</p> <p>Então a conclusão interessante é que para adição e subtração não importa se você usa <code class="docutils literal">unsigned int</code> ou <code class="docutils literal">int</code> em variáveis em C. O propósito da palavra-chave <code class="docutils literal">unsigned</code> é dar o contexto que falta para o compilador, para que ele use a instrução correta em operações com esse número no assembly gerado, e é crucial para a comparação entre números (<code class="docutils literal">ja</code> vs <code class="docutils literal">jg</code>, <code class="docutils literal">jb</code> vs <code class="docutils literal">jl</code>), multiplicação (<code class="docutils literal">mul</code> vs <code class="docutils literal">imul</code>) e divisão (<code class="docutils literal">div</code> vs <code class="docutils literal">idiv</code>). Mas graças ao complemento de dois, na soma e subtração não tem como errar 🙂.</p> <p>Tangente: interessantemente, enquanto eu escrevia esse artigo, eu li na página da Wikipédia (<a class="reference external" href="https://en.wikipedia.org/wiki/Two%27s_complement">em inglês</a>) que o complemento de dois também funciona da mesma forma para multiplicação, mas só se o sinal dos operandos for primeiramente estendido. Isso me faz pensar que se a instrução <code class="docutils literal">mul</code> sempre fizesse o passo de extensão do sinal, também não haveria necessidade para uma instrução <code class="docutils literal">imul</code>, mas isso provavelmente aumentaria a complexidade (e custo) do circuito lógico.</p> </div> <div class="section" id="outros-aprendizados-interessantes"> <h2>Outros aprendizados interessantes</h2> <p>A outra coisa que mais me interessou foi perceber que variáveis locais não são nada mais do que adicionar mais espaço na pilha. E que isso é feito simplesmente subtraindo do registrador da pilha <code class="docutils literal">rsp</code> o total de bytes necessário para todas as variáveis no começo de uma subrotina.</p> <p>Também interessante foi aprender que existem <a class="reference external" href="https://en.wikipedia.org/wiki/X86_calling_conventions#x86-64_calling_conventions">convenções de chamada</a> para padronizar:</p> <ul class="simple"> <li>quais registradores são usados para passar argumentos para subrotinas e em qual ordem;</li> <li>quais registradores podem ser sobrescritos por uma subrotina e quais devem ser mantidos intactos. No caso do uso destes últimos, o valor do registrador deve ser primeiro empurrado para a pilha para que depois possa ser recuperado antes de retornar.</li> </ul> <p>E quanto à função mágica <code class="docutils literal">main()</code> que o compilador de C espera encontrar em todo programa em C? Assembly não requer compilação, então ela não é necessária, mas no final das contas uma outra label mágica é esperada pelo ligador: <code class="docutils literal">_start</code>.</p> <p>Outras coisas que foram interessantes de fazer em assembly:</p> <ul class="simple"> <li>Fazer syscalls</li> <li>Tirar vantagem de um overflow de buffer na pilha</li> <li>Interagir código assembly com código em C, e vice-versa.</li> </ul> </div> <div class="section" id="falta-de-uma-boa-gui"> <h2>Falta de uma boa GUI</h2> <p>Uma coisa que eu senti falta foi de uma boa aplicação GUI quando estava depurando os programas em assembly. Teria sido muito útil ter uma que mostrasse os valores de expressões em tooltips quando deixasse o mouse em cima, que pulasse para labels quando clicasse nelas, etc.</p> <p>O livro recomenda usar o DDD, que é uma GUI, mas eu não achei ele muito agradável de usar e era claramente velho. Então eu acabei usando o GDB junto com o plugin <a class="reference external" href="https://github.com/longld/peda">peda</a>, e funcionou razoavelmente bem, mas por ser uma CLI, cada inspeção requeria descobrir o comando certo, então levava mais tempo para se orientar.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Essa foi uma ótima experiência e eu espero no futuro aprofundar meu conhecimento além do nível básico de x86-64. Ver o que está acontecendo no nível do assembly realmente ajuda a entender melhor as linguagens de alto-nível, e a valorizar as complexidades que elas escondem!</p> <p>Eu subi o código que eu escrevi para todos os exercícios do livro <a class="reference external" href="https://codeberg.org/nfraprado/x86-64-book-exercises">para esse repositório</a>. Eu não acho que vai ser útil para ninguém porque são coisas simples, mas está lá de qualquer forma.</p> <p>O único exercício que eu não consegui completar foi o último. Tinha muito pouca informação no livro sobre como realizá-lo, e durante a pesquisa sobre o tópico online eu acabei me desanimando e comecei a aprender sobre outros assuntos. Mas talvez um dia eu tente de novo. Se você souber como fazê-lo, <a class="reference external" href="/pages/about.html">entre em contato</a>! 🙂</p> <p>E apesar de eu não ter conseguido concluir esse último exercício, foi durante a pesquisa sobre ele que eu acabei aprendendo como usar a sintaxe do <code class="docutils literal">asm</code> no GCC <a class="reference external" href="https://www.felixcloutier.com/documents/gcc-asm.html">através desse guia</a>, para escrever código assembly dentro de um arquivo em C, e também conheci o <a class="reference external" href="https://godbolt.org/">Compiler Explorer</a> que parece uma ótima forma de aprender sobre assembly e C olhando qual assembly é gerado para um certo código em C, então estou considerando como uma vitória!</p> </div> Deixando links internos no pelican triviais2022-01-20T00:00:00-03:002022-01-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2022-01-20:/pt-br/post/deixando-links-internos-no-pelican-triviais.html<p>Uma funcionalidade interessante do <a class="reference external" href="https://github.com/getpelican/pelican">Pelican</a>, o gerador de site estático que eu uso para esse blog, é a sintaxe de expansão de links internos usando <code class="docutils literal">{}</code>. Ela está documentada <a class="reference external" href="https://docs.getpelican.com/en/latest/content.html?highlight=static#linking-to-internal-content">aqui</a>. Alguns exemplos são <code class="docutils literal">{filename}</code>, <code class="docutils literal">{static}</code> e <code class="docutils literal">{author}</code>. O propósito da sintaxe é ter apelidos mais curtos e fáceis na hora de …</p><p>Uma funcionalidade interessante do <a class="reference external" href="https://github.com/getpelican/pelican">Pelican</a>, o gerador de site estático que eu uso para esse blog, é a sintaxe de expansão de links internos usando <code class="docutils literal">{}</code>. Ela está documentada <a class="reference external" href="https://docs.getpelican.com/en/latest/content.html?highlight=static#linking-to-internal-content">aqui</a>. Alguns exemplos são <code class="docutils literal">{filename}</code>, <code class="docutils literal">{static}</code> e <code class="docutils literal">{author}</code>. O propósito da sintaxe é ter apelidos mais curtos e fáceis na hora de linkar com conteúdo interno no blog. Por exemplo, <code class="docutils literal">{filename}</code> pode ser usado para linkar com outros arquivos, como artigos.</p> <p>A ideia é boa, mas para o meu uso ela não é o suficiente. Onde eu preciso realmente de expansão de links internos no meu blog é para imagens, artigos e código.</p> <div class="section" id="imagens"> <h2>Imagens</h2> <p>A ideia para imagens é bem simples. Eu escrevo meus artigos em <a class="reference external" href="https://docutils.sourceforge.io/rst.html">rst</a>, e é assim que uma imagem é incluída nesse formato:</p> <div class="highlight"><pre><span></span><span class="p">..</span> <span class="ow">image</span><span class="p">::</span> caminho/ate/imagem.jpg </pre></div> <p>O jeito que eu estruturo os arquivos no meu blog (que você pode ver <a class="reference external" href="https://codeberg.org/nfraprado/blog">no repositório do blog</a>), é que dentro da pasta <code class="docutils literal">content</code> onde todo conteúdo fica, os fontes dos artigos podem ser encontrados dentro de <code class="docutils literal">articles/&lt;ano&gt;/</code>, e as imagens podem ser encontradas em <code class="docutils literal">images/&lt;id_artigo&gt;/</code>, onde <code class="docutils literal">&lt;id_artigo&gt;</code> é a string que identifica o artigo no qual a imagem aparece (ele é a propriedade <code class="docutils literal">trans_id</code> do artigo, derivada do nome do arquivo e usada para associar traduções de um mesmo artigo, mas eu estou chamando de <code class="docutils literal">id_artigo</code> aqui já que faz mais sentido nesse contexto).</p> <p>Dada essa estrutura, se eu usar um caminho relativo do artigo até uma de suas imagens, ele teria que ser algo como <code class="docutils literal">../../images/&lt;id_artigo&gt;/nome_da_imagem.jpg</code>. A expansão <code class="docutils literal">{static}</code> pode ser usada para simplificá-lo um pouco: <code class="docutils literal">{static}/images/&lt;id_artigo&gt;/nome_da_imagem.jpg</code>. Mas dá para fazer melhor 🙂.</p> <p>Seria muito melhor se esse caminho pudesse ser bastante encurtado. Todas as imagens estão dentro da pasta <code class="docutils literal">images/</code>, então isso deveria estar implícito. Quer saber, já que já estamos aqui mesmo, por que não fazer a parte <code class="docutils literal">&lt;id_artigo&gt;/</code> ser derivada do id do artigo atual. Isso deixaria o link perfeito, já que apenas sobraria o nome da imagem, que é a parte dele que é única.</p> <p>O primeiro passo para implementar essa lógica customizada foi adicionar o <a class="reference external" href="https://github.com/getpelican/pelican-plugins/blob/master/linker/linker.py">plugin linker</a> no pelican. Ele permite que você implemente suas próprias expansões de links <code class="docutils literal">{}</code> através de classes em python.</p> <p>E o segundo passo foi implementar a expansão <code class="docutils literal">{image}</code> através <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/fb4238f841f9a242bdf5f20badd5bb50ccb221b4">desse commit</a>. <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/dbaaace5ba0e00e2f378ba8c8d7e80b6c36d4326">Esse é o commit</a> onde eu atualizei todos os links de imagem para usar <code class="docutils literal">{image}</code>. Sinta o prazer! Ficou muito mais enxuto 🙂.</p> </div> <div class="section" id="artigos"> <h2>Artigos</h2> <p>Linkar com outros artigos é um pouco mais complicado, mas não tanto. A ideia é, às vezes eu quero referenciar outro artigo que eu escrevi anteriormente no blog. Usando a expansão <code class="docutils literal">{filename}</code>, não fica tão ruim:</p> <div class="highlight"><pre><span></span>Eu mostrei isso <span class="s">`em um artigo anterior`__</span>. <span class="p">..</span> <span class="nt">__:</span> {filename}08-task-context-br.rst </pre></div> <p>Mas com certeza poderia ser melhor. A expansão <code class="docutils literal">{filename}</code> é relativa ao arquivo atual, então se eu estou referenciando um artigo do mesmo ano, fica igual nesse exemplo mesmo, mas referenciar um de outro ano requer um <code class="docutils literal">../&lt;ano&gt;/</code> adicional no caminho. Além disso, eu não deveria precisar escrever o nome do arquivo inteiro. Idealmente eu só deveria precisar escrever o que é único ao artigo, ou seja, o seu <code class="docutils literal">id_artigo</code>. Sim, até o sufixo da língua (<code class="docutils literal">-en</code> ou <code class="docutils literal">-br</code>) pode ser omitido, já que eu posso derivá-lo da língua do artigo atual.</p> <p>Até agora tudo bem, isso poderia ser feito com um pouco mais de lógica além do que eu fiz para o <code class="docutils literal">{image}</code>. Mas já que eu já estou melhorando as coisas, eu gostaria de aproveitar essa chance para padronizar melhor o texto que eu uso nesses links. Tudo bem, usar um texto como &quot;em um artigo anterior&quot; se encaixa bem com o texto à sua volta, mas não fica imediatamente óbvio que o link é para um outro artigo no meu blog.</p> <p>Então a ideia é ter uma expansão de link que não só mapeia para o caminho correto do artigo, mas também automaticamente muda seu texto para conter o título do artigo. Um toque final é que eu quero que esse texto leve em consideração a língua do artigo: se está em português, o formato deve ser 'artigo &quot;Título do artigo&quot;' e se está em inglês, '&quot;Título do artigo&quot; post'.</p> <p>Atualizar o texto do link não é algo que o plugin linker consegue fazer por padrão, então eu primeiro precisei estendê-lo para permitir isso <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/e6a0ea78e2898b7e7004aff9aa17e6be354dbdd8">nesse commit</a>. Com o mecanismo base feito, eu de fato implementei a nova expansão <code class="docutils literal">{article}</code> <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/ff4f7fc0cc4a418a19574e41510e8f28a62c5e31">nesse commit</a>.</p> <p>Todo esse trabalho vale a pena, já que agora eu posso te mostrar como o resultado ficou te apontando para o primeiro artigo que eu escrevi nesse blog usando um simples <code class="docutils literal">{article}tasklist</code>: <a class="reference external" href="/pt-br/post/criando-listas-de-filmes-e-jogos-usando-taskwarrior.html">artigo "Criando listas de filmes e jogos usando Taskwarrior"</a></p> <p>Claro que eu também atualizei todas as referências a artigos no blog para usar essa nova e excelente expansão <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/c83e1cc8a8484777776a7b6fd70f758a84c351d1">nesse commit</a>.</p> </div> <div class="section" id="codigo"> <h2>Código</h2> <p>É aqui que complica... Bem, como você deve saber, é bem comum os artigos do meu blog, por serem técnicos, terem blocos de código no meio do texto. Eu incluo esses códigos usando a diretiva rst <code class="docutils literal">include</code> e passando para ela o caminho de um arquivo separado que contém o código.</p> <p>O problema é, diferentemente da diretiva rst <code class="docutils literal">image</code> e os links rst cujos alvos aparecem no HTML final, o que torna bem simples editá-los dentro do pelican, a diretiva <code class="docutils literal">include</code> e seu caminho são processados pelo leitor rst em um estágio anterior. Isso significa que os métodos normais para mudar um link no pelican não podem ser usados aqui (como o plugin linker).</p> <p>Eu poderia colocar o código direto no fonte do artigo ao invés de usar a diretiva <code class="docutils literal">include</code> e evitar todo esse problema, mas quando o código tem mais do que algumas linhas, eu sinto que isso poluiria muito o arquivo fonte do artigo.</p> <p>Bem, se você já leu o <a class="reference external" href="/pt-br/post/customizacoes-do-blog.html">artigo "Customizações do blog"</a> você deve lembrar que eu já tenho um leitor rst customizado. Então para implementar uma expansão de link para código, eu precisava extender esse leitor para substituir qualquer ocorrência de <code class="docutils literal">{code}</code> dentro de uma diretiva <code class="docutils literal">include</code> pelo caminho do arquivo de código. Foi isso que eu fiz <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/8d8f03b5fd5448d1c880f782555f6f4e1717a36c">nesse commit</a>, copiando o código do leitor rst do pelican e fazendo algumas mudanças.</p> <p>Vale a pena dizer que esse tipo de customização que estou fazendo (e já estava fazendo) de sobrescrever o leitor rst não é bem estável. Se houverem mudanças no leitor rst do pelican, eu posso ter que parar de atualizar o pelican ou reimplementar as mudanças deles no meu leitor customizado. Mas já que não tinha um jeito menos intrusivo de implementar essa funcionalidade, eu resolvi correr esse risco.</p> <p>Apesar das mudanças não muito atraentes, no fim tudo vale a pena quando você vê a melhora nos arquivos fontes dos artigos. <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/3007137d04992b6720cd88691b25ec7bb5a6995a">Esse é o commit</a> onde eu atualizei eles para usar a nova expansão <code class="docutils literal">{code}</code>. Duvido que você diga que não valeu a pena (por favor não diga).</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>E aqui estamos. Deu um certo trabalho, mas depois dessas mudanças, nunca foi tão fácil de fazer links internos no meu blog! Tudo que deixa mais fácil de escrever artigos para o blog vale muito a pena para mim.</p> </div> Os menus do meu sistema2021-12-28T00:00:00-03:002021-12-28T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-12-28:/pt-br/post/os-menus-do-meu-sistema.html<p>Outro artigo falando sobre algo que eu configurei no meu ambiente de trabalho alguns anos atrás e que continuo usando até hoje 🙂. Dessa vez eu vou mostrar os menus que eu criei usando o <a class="reference external" href="https://github.com/davatorium/rofi">rofi</a>.</p> <p>Então, o que é o <a class="reference external" href="https://github.com/davatorium/rofi">rofi</a>? É basicamente um programa para o qual você fornece …</p><p>Outro artigo falando sobre algo que eu configurei no meu ambiente de trabalho alguns anos atrás e que continuo usando até hoje 🙂. Dessa vez eu vou mostrar os menus que eu criei usando o <a class="reference external" href="https://github.com/davatorium/rofi">rofi</a>.</p> <p>Então, o que é o <a class="reference external" href="https://github.com/davatorium/rofi">rofi</a>? É basicamente um programa para o qual você fornece uma lista de opções, e ele mostra uma janela onde o usuário pode filtrar e escolher uma opção. Então basicamente pode-se dizer que é um menu de seleção simples mas universal.</p> <p>O rofi também tem alguns menus padrões, como um para abrir aplicações e outro para alternar entre janelas, que provavelmente são o seu uso mais comum. Eu também uso esses menus, mas como eles não são algo que eu mesmo customizei, eu não vou falar sobre eles.</p> <div class="section" id="meus-menus"> <h2>Meus menus</h2> <p>Os menus que eu criei usando o rofi são: power, screenshot, unicode e music.</p> <div class="section" id="power"> <h3>Power</h3> <img alt="{image}/power.png" src="/images/rofi/power.png" /> <p>Esse é provavelmente o menu mais importante de se ter quando seu ambiente de trabalho não oferece o próprio menu (por exemplo, no meu caso eu uso sway que é apenas um gerenciador de janelas e não tem nenhum menu próprio). Esse menu fica mapeado em <code class="docutils literal">Super+Shift+P</code>.</p> <p>As opções são auto-explicativas. Elas são ordenadas de menos &quot;danosa&quot; no topo até mais &quot;danosa&quot; em baixo, para que eu não desligue e perca meu trabalho acidentalmente quando eu apenas quero bloquear a tela, por exemplo, já que não tem nenhum pop-up de confirmação.</p> <p>Já que <code class="docutils literal">lock</code> é a primeira opção, simplesmente abrir o menu e apertar <code class="docutils literal">Enter</code> já bloqueia a tela. A outra opção que eu mais uso é <code class="docutils literal">hibernate</code>, que apenas requer pressionar <code class="docutils literal">h</code> para ser selecionada, seguido de <code class="docutils literal">Enter</code> para hibernar. Nos casos raros que eu realmente preciso desligar eu uso <code class="docutils literal">w</code>, e para reiniciar, eu uso <code class="docutils literal">re</code>. Claro que eu sempre posso circular pelas opções usando <code class="docutils literal">Ctrl+N</code> e <code class="docutils literal">Ctrl+P</code> também, mas as letras geralmente são mais rápidas.</p> <p>O motivo de ter muito espaço entre cada ícone e o texto é que cada ícone tem uma largura diferente, então para que o texto de todas as entradas fique alinhado, eu precisei colocar um caractere de tab depois de cada ícone. O mesmo é feito nos outros menus.</p> </div> <div class="section" id="screenshot"> <h3>Screenshot</h3> <img alt="{image}/screenshot.png" src="/images/rofi/screenshot.png" /> <p>O menu screenshot fica mapeado em <code class="docutils literal">Super+Shift+S</code>.</p> <p>A opção <code class="docutils literal">screen</code> tira uma foto da tela inteira (incluindo monitores externos). Ela chama o <a class="reference external" href="https://github.com/emersion/grim">grim</a> por baixo dos panos para tirar as fotos.</p> <p><code class="docutils literal">region</code> disponibiliza um cursor que me permite selecionar a região retangular que será capturada na foto. Isso é feito chamando o <a class="reference external" href="https://github.com/emersion/slurp">slurp</a>, que obtém a seleção do usuário, e fornece as coordenadas resultantes para o <code class="docutils literal">grim</code> através do seu parâmetro <code class="docutils literal">-g</code>.</p> <p><code class="docutils literal">window</code> também disponibiliza um cursor, mas ele é usado para selecionar uma única janela que será capturada. Isso é feito extraindo as dimensões das janelas do sway e as passando como opções para o <code class="docutils literal">slurp</code> que então permite que apenas um desses retângulos seja selecionado. O comando que faz isso, disponível no README do slurp, é:</p> <pre class="code literal-block"> swaymsg -t get_tree | jq -r '.. | select(.pid? and .visible?) | .rect | \&quot;\(.x),\(.y) \(.width)x\(.height)\&quot;' | slurp </pre> <p><code class="docutils literal">colorpicker</code> disponibiliza um cursor também, mas não tira nenhuma foto, o que ele faz é copiar o valor RGB do pixel que for clicado para o <em>clipboard</em>.</p> </div> <div class="section" id="unicode"> <h3>Unicode</h3> <img alt="{image}/unicode.png" src="/images/rofi/unicode.png" /> <p>O menu unicode fica mapeado em <code class="docutils literal">Super+Shift+U</code>.</p> <p>O propósito desse menu é facilitar o acesso a caracteres que eu normalmente não tenho mapeado no meu teclado. Ele mostra cada caractere e seu nome. Já que há muitos caracteres, eu uso duas colunas no rofi para conseguir ver mais ao mesmo tempo.</p> <p>Para usar esse menu eu escrevo o nome do caractere que eu quero e, com ele selecionado, pressiono <code class="docutils literal">Enter</code> para copiá-lo para o <em>clipboard</em>. Então eu posso colá-lo onde eu estava precisando.</p> <p>Um exemplo de uso é para pegar os caracteres ordinais usados em português: ª e º (chamados Indicador Ordinal Feminino e Masculino, respectivamente). Esses caracteres estão mapeados no layout português do teclado, mas para mim é mais fácil encontrar buscando no menu do que achar no teclado.</p> <p>Esse menu é gerado em python usando a função <code class="docutils literal">unicodedata.name()</code> para obter o nome Unicode para cada caractere e <code class="docutils literal">chr()</code> para obter o caractere em si. <code class="docutils literal">wl-copy</code> é usado para copiar o caractere para o <em>clipboard</em>.</p> </div> <div class="section" id="music"> <h3>Music</h3> <img alt="{image}/music.png" src="/images/rofi/music.png" /> <p>O menu de música fica mapeado em <code class="docutils literal">Super+Shift+M</code> e é o meu favorito! Cada opção abre seu próprio sub-menu. Ele tem tudo que eu preciso para sempre poder rapidamente tocar a música que eu quero.</p> <p>Um detalhe legal é que se uma música já está tocando, o que você escolher vai tocar apenas depois que a música atual terminar. Caso contrário, se nenhuma música está tocando, a escolha é tocada imediatamente. Desse jeito, a música atual nunca é parada no meio, o que é ótimo.</p> <p>Além disso, diferentemente dos outros menus, os sub-menus de música permitem (quando fizer sentido) que múltiplas opções sejam selecionadas usando <code class="docutils literal">Shift+Enter</code> ao invés de <code class="docutils literal">Enter</code>, apesar de eu raramente usar isso.</p> <p>Vamos ver cada um dos sub-menus.</p> <div class="section" id="playlist"> <h4>Playlist</h4> <img alt="{image}/music-playlist.png" src="/images/rofi/music-playlist.png" /> <p>O menu playlist me permite tocar qualquer uma das minhas listas de reprodução. A randomização é ligada automaticamente quando eu seleciono uma lista de reprodução, para que a ordem das músicas na lista não seja sempre a mesma.</p> <p>A lista de reprodução que eu mais ouço, <code class="docutils literal">Saved</code>, é a primeira propositalmente. Assim, quando eu simplesmente quero escutar <em>qualquer coisa</em>, basta apertar <code class="docutils literal">Super+Shift+M</code>, <code class="docutils literal">Enter</code>, <code class="docutils literal">Enter</code>. Escutar música de fundo quando eu preciso me concentrar também é bem fácil: <code class="docutils literal">Super+Shift+M</code>, <code class="docutils literal">Enter</code>, <code class="docutils literal">Ctrl+N</code>, <code class="docutils literal">Enter</code>.</p> <p>Caso você esteja curioso sobre como as listas de reprodução são criadas, eu já escrevi sobre no <a class="reference external" href="/pt-br/post/geracao-de-listas-de-reproducao-de-musica-com-o-mpd.html">artigo "Geração de listas de reprodução de música com o MPD"</a>.</p> </div> <div class="section" id="song"> <h4>Song</h4> <img alt="{image}/music-song.png" src="/images/rofi/music-song.png" /> <p>O menu song é para quando eu quero ouvir alguma música específica. Cada entrada mostra o nome da música, artista e álbum. O rofi não suporta mostrar múltiplas strings na mesma entrada desse jeito por padrão, então para conseguir isso eu preciso construir uma string com a mesma largura da janela do rofi, com cada campo ocupando uma parcela igual.</p> <p>Para ter uma largura mais ou menos previsível eu fixo a largura do rofi em termos de caracteres colocando <code class="docutils literal">width: -100;</code> no seu config. Então eu disponibilizo esse valor dentro do script python simplesmente lendo o valor desse arquivo de config (nada elegante, mas funciona). Por fim eu calculo a largura de cada campo, e adiciono espaçamento e/ou trunco cada um dos campos individualmente para mantê-los na largura desejada.</p> <p>Já que a fonte que eu uso no rofi não é monoespaçada, a largura que eu configuro no config é apenas um estimativa e não é precisa de forma alguma. Então pode ter um pouco de folga, mas funciona bem o suficiente.</p> </div> <div class="section" id="queue"> <h4>Queue</h4> <img alt="{image}/music-queue.png" src="/images/rofi/music-queue.png" /> <p>O menu queue mostra a fila de músicas atual que está tocando. Eu uso ele quando quero ver as próximas músicas que vão tocar ou tocar uma outra música da fila atual.</p> <p>Quando esse menu é aberto o cursor começa já selecionando a música que está tocando no momento.</p> </div> <div class="section" id="album"> <h4>Album</h4> <img alt="{image}/music-album.png" src="/images/rofi/music-album.png" /> <p>O menu album me permite tocar um álbum inteiro. Uma diferença importante dos outros menus é que tocar um álbum desliga a randomização, para que as músicas do álbum sejam tocadas na ordem correta.</p> <p>Cada entrada mostra o nome do álbum e do artista. Na frente também tem um <code class="docutils literal">%</code> para marcar o que eu chamo de &quot;álbum completo&quot;. O critério é que quando eu gosto de pelo menos 80% das músicas de um álbum, eu marco ele com um <code class="docutils literal">%</code>, e passo a escutá-lo por completo, mesmo as músicas que eu não gostei tanto. Por outro lado, se eu gosto de menos de 80% das músicas no álbum, eu só ouço as músicas que eu gostei.</p> <p>A ideia por trás desse conceito de &quot;álbum completo&quot; é que eu acho que existe um certo valor em escutar um álbum por completo, mas ao mesmo tempo não acho que faz sentido ouvir um álbum completo quando você não gosta de muitas das músicas. Então eu inventei essa folga de 20% para que os álbuns não precisem ser perfeitos para que eu esteja disposto a escutá-los por completo.</p> </div> <div class="section" id="artist"> <h4>Artist</h4> <img alt="{image}/music-artist.png" src="/images/rofi/music-artist.png" /> <p>O menu artist é o que eu uso para tocar todas as músicas e álbuns de um único artista, em uma ordem qualquer.</p> </div> <div class="section" id="current"> <h4>Current</h4> <img alt="{image}/music-current.png" src="/images/rofi/music-current.png" /> <p>O menu current é uma adição bem nova! Eu percebi que às vezes estou ouvindo uma lista de reprodução e uma música toca que me faz querer ouvir o álbum dela inteiro ou todas as músicas desse artista. Esse menu me permite fazer exatamente isso.</p> </div> <div class="section" id="options"> <h4>Options</h4> <img alt="{image}/music-options.png" src="/images/rofi/music-options.png" /> <p>O menu options dá acesso a mais algumas funcionalidades extras. <code class="docutils literal">update</code> faz o MPD atualizar seu banco de dados de música, o que às vezes é útil se acabei de editar um arquivo. <code class="docutils literal">random</code> liga ou desliga a randomização de músicas. Eu raramente uso isso já que meus menus já são configurados para ligar ou desligar a randomização com base no contexto. <code class="docutils literal">update playlists</code> roda meu script de geração de listas de reprodução para que elas sejam atualizadas.</p> </div> </div> </div> <div class="section" id="outras-consideracoes"> <h2>Outras considerações</h2> <p>Esses são meus menus e o que eu queria compartilhar nesse artigo, mas vale mencionar alguns outros pontos.</p> <p>Primeiro, tem um outro menu rofi que eu uso e gosto, mas ele não é um que eu mesmo criei. Ele se chama <a class="reference external" href="https://github.com/fdw/rofimoji">rofimoji</a> e permite que você muito facilmente pesquise e copie emojis.</p> <p>Em segundo lugar, vale mencionar que o rofi oficialmente só funciona no X11, então eu na verdade uso o <a class="reference external" href="https://aur.archlinux.org/packages/rofi-lbonn-wayland-git/">fork do rofi para wayland</a>, como eu mencionei no <a class="reference external" href="/pt-br/post/mudando-para-o-wayland.html">artigo "Mudando para o Wayland"</a>.</p> <p>E finalmente, para tornar a criação de menus rofi mais fácil nos meus scripts em python, eu abstraí a execução do rofi em uma função python com o seguinte protótipo:</p> <div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">select</span><span class="p">(</span><span class="n">prompt</span><span class="p">,</span> <span class="n">options</span><span class="p">,</span> <span class="n">multi</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">args</span><span class="o">=</span><span class="p">[]):</span> </pre></div> <p>onde <code class="docutils literal">prompt</code> é a string que aparece no prompt, <code class="docutils literal">options</code> é a lista de opções que podem ser escolhidas, <code class="docutils literal">multi</code> representa se múltiplas opções podem ser escolhidas ou não, e <code class="docutils literal">args</code> permite passar argumentos adicionais ao rofi. O retorno da função é a/as opção/opções que foi/foram selecionada(s) (apenas a opção se <code class="docutils literal">multi</code> era falso, ou a lista de opções se era verdadeiro). Se a seleção foi abortada uma exceção é lançada. Eu considerei usar o <a class="reference external" href="https://github.com/bcbnz/python-rofi">python-rofi</a> ao invés de criar meu próprio módulo, mas esse módulo retorna o índice do que foi escolhido ao invés da string em si, o que apenas tornaria o uso mais complicado. Já que era bem fácil criar meu próprio módulo, foi o que eu fiz.</p> <p>E é isso. Eu realmente gosto do quão fácil é criar menus usando o rofi em python 🙂.</p> </div> Os blocos na minha barra de status2021-11-26T00:00:00-03:002021-11-26T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-11-26:/pt-br/post/os-blocos-na-minha-barra-de-status.html<p>Cinco anos atrás quando eu mudei para o gerenciador de janelas i3, eu comecei a usar a barra de status dele, o i3bar. Ele é baseado em texto e depende de você o que é mostrado lá. Mas ele não é muito modular: é estranho combinar informações diferentes já que …</p><p>Cinco anos atrás quando eu mudei para o gerenciador de janelas i3, eu comecei a usar a barra de status dele, o i3bar. Ele é baseado em texto e depende de você o que é mostrado lá. Mas ele não é muito modular: é estranho combinar informações diferentes já que tudo precisa ser juntado em uma única string manualmente.</p> <p>Mais ou menos um ano depois eu descobri um programa que resolve esse problema: <a class="reference external" href="https://github.com/vivien/i3blocks">i3blocks</a>. O funcionamento dele é baseado em um config onde você define os blocos que você quer e qual o script que vai ser rodado para cada um. A saída de texto de cada script é o que vai ser mostrado para esse bloco na barra de status.</p> <div class="section" id="meus-blocos"> <h2>Meus blocos</h2> <p>Eu atualmente tenho 9 blocos na minha barra de status: hora, rotina, tarefa, bateria, teclado, armazenamento-root, armazenamento-home, atualização e música.</p> <div class="section" id="hora"> <h3>Hora</h3> <img alt="{image}/time.png" src="/images/i3blocks/time.png" /> <p>Provavelmente o bloco mais óbvio. Eu não consigo pensar em nenhuma barra de status que não mostre a hora atual...</p> <p>Esse bloco mostra a data (dia da semana, dia, mês e ano) e hora. Mostrar a hora em negrito é um detalhe que eu gosto bastante, mas não lembro de onde eu peguei a ideia.</p> </div> <div class="section" id="rotina"> <h3>Rotina</h3> <img alt="{image}/schedule.png" src="/images/i3blocks/schedule.png" /> <p>Esse bloco me mostra a rotina atual, ou seja, o que eu deveria estar fazendo agora. Como você pode ver agora eu deveria estar lendo um livro ao invés de escrever esse artigo para o blog... Mas eu preciso correr se quiser publicar ele! 😝</p> <p>Eu já mostrei esse bloco anteriormente no <a class="reference external" href="/pt-br/post/organizacao-alem-do-taskwarrior.html">artigo "Organização além do Taskwarrior"</a>.</p> </div> <div class="section" id="tarefa"> <h3>Tarefa</h3> <img alt="{image}/task.png" src="/images/i3blocks/task.png" /> <p>Esse bloco mostra o contexto de tarefas atual e o número de tarefas que eu tenho na minha caixa de entrada, o número de projetos empacados e o número de tarefas com prazos próximos.</p> <p>Quando todos os três são zero, esse bloco é escondido, apesar de isso ser bem raro. Como você pode ver, eu não tenho tido tempo ultimamente para organizar as tarefas da minha caixa de entrada 😅.</p> <p>Eu também já mostrei esse bloco no artigo <a class="reference external" href="/pt-br/post/organizacao-alem-do-taskwarrior.html">artigo "Organização além do Taskwarrior"</a>.</p> </div> <div class="section" id="bateria"> <h3>Bateria</h3> <img alt="{image}/battery.png" src="/images/i3blocks/battery.png" /> <p>Esse bloco mostra a porcentagem atual de carga da bateria. O ícone reflete a carga atual (dentre 4 possibilidades), e quando a bateria está baixa o fundo fica vermelho para chamar minha atenção.</p> <p>Quando a bateria está carregando e com uma carga alta, esse bloco fica oculto.</p> </div> <div class="section" id="teclado"> <h3>Teclado</h3> <img alt="{image}/keyboard.png" src="/images/i3blocks/keyboard.png" /> <p>Esse bloco me mostra o layout atual do teclado. Já que eu só uso dois layouts, pt-br (ABNT2) e en-us, e na maior parte do tempo eu uso o inglês, esse bloco só mostra em vermelho quando eu estou no layout português. Quando estou no inglês, ele fica oculto.</p> <p>Eu adicionei esse bloco depois de tentar usar o vim várias vezes tendo esquecido que estava com o layout português.</p> </div> <div class="section" id="armazenamento"> <h3>Armazenamento</h3> <img alt="{image}/storage-root.png" src="/images/i3blocks/storage-root.png" /> <img alt="{image}/storage-home.png" src="/images/i3blocks/storage-home.png" /> <p>Esses dois blocos mostram o espaço de armazenamento disponível e total nos meus discos. O primeiro (ícone de computador) mostra para a partição root, enquanto o segundo (ícone de casa) mostra para a partição home. Esses blocos ficam quase sempre escondidos, a não ser que o espaço disponível fique baixo. Nesse caso eles aparecem com o fundo vermelho.</p> <p><strong>Obs</strong>: O espaço livre mostrado nessas fotos normalmente não seria considerado baixo, eu que forcei eles a aparecerem.</p> </div> <div class="section" id="atualizacao"> <h3>Atualização</h3> <img alt="{image}/update.png" src="/images/i3blocks/update.png" /> <p>Esse bloco me mostra o número de pacotes que precisam ser atualizados. Ele apenas aparece se o número for alto o suficiente, caso contrário fica oculto.</p> <p>Antigamente eu fazia com o que o fundo desse bloco ficasse vermelho se o pacote do kernel precisasse ser atualizado, já que eu percebi que no Arch Linux atualizar o kernel não mantém os módulos da versão anterior. Isso significa que sempre após atualizar o kernel o sistema deve ser reiniciado, caso contrário alguns bugs estranhos podem acontecer devido à falta de módulos necessários (por exemplo, USBs não funcionarem). Porém depois de descobrir o pacote <a class="reference external" href="https://archlinux.org/packages/community/any/kernel-modules-hook/">kernel-modules-hook</a> que resolve esse problema, eu removi essa checagem e nem me preocupo mais na hora de atualizar o kernel.</p> </div> <div class="section" id="musica"> <h3>Música</h3> <img alt="{image}/music.png" src="/images/i3blocks/music.png" /> <p>Esse bloco me mostra a música que está sendo tocada atualmente. Ele mostra o artista seguido do nome da música, e o ícone reflete o estado atual: tocando ou pausado. Quando nenhuma música está tocando ele fica oculto.</p> <p>Como nome de banda ou música podem ficar grandes, a partir de um certo tamanho eu omito o restante usando um &quot;...&quot;.</p> </div> <div class="section" id="bloco-antigo-cardapio-unicamp"> <h3>Bloco antigo: cardapio-unicamp</h3> <img alt="{image}/cardapio-unicamp.png" src="/images/i3blocks/cardapio-unicamp.png" /> <img alt="{image}/cardapio-unicamp-semana.png" src="/images/i3blocks/cardapio-unicamp-semana.png" /> <p>Esse não é um bloco que eu uso atualmente, mas era meu favorito então eu quero mencioná-lo. Seu propósito era me informar qual o cardápio do bandejão da faculdade, para que eu pudesse decidir se queria comer lá ou em outro lugar.</p> <p>Houveram duas iterações. No começo, eu simplesmente mostrava a descrição do prato principal da próxima refeição. Depois de um tempo eu mudei ele para me mostrar a qualidade das refeições para a semana inteira. Eu fiz isso comparando a descrição do prato com palavras que eu considerava bom ou ruim. O resultado final eram dez quadrados, cada dia separado por um <code class="docutils literal">|</code> e em cada um o primeiro quadrado mostrava almoço e o segundo, a janta. A cor dos quadrados mostrava a qualidade: branco para normal, verde para bom e vermelho (ou magenta nesse esquema de cores antigo) para ruim.</p> <p>Os cardápios eram obtidos usando um programa em python que eu escrevi chamado <a class="reference external" href="https://codeberg.org/nfraprado/cardapio-unicamp">cardapio-unicamp</a>. O script para obter a qualidade dos pratos para a semana inteira <a class="reference external" href="https://codeberg.org/nfraprado/cardapio-unicamp/src/branch/master/exemplos/cardapio_ru_semana.py">também está disponível nesse repositório</a>. A conversão de <code class="docutils literal">|</code>, <code class="docutils literal">+</code> e <code class="docutils literal">-</code> para os quadrados coloridos eu não tenho publicada, mas eram algumas simples (mas feias) linhas de bash, então eu tenho certeza que você consegue fazer algo melhor que isso se quiser 🙂.</p> </div> </div> <div class="section" id="melhorias"> <h2>Melhorias</h2> <p>Eu realmente gosto da configuração atual da minha barra de status, mas levou tempo e melhorias para chegar aqui.</p> <p>Por exemplo eu sinto que consistência é importante para que seja fácil de identificar cada bloco: cada um tem sua própria cor acima e um pouco de espaço em volta, e seu ícone sempre é a primeira coisa à esquerda, seguido do texto.</p> <p>Eu também aproveito o uso de cores para reduzir a quantidade de texto usada nos blocos. Por exemplo, o bloco de tarefa possui três números diferentes, mas eles não precisam de legenda, já que cada cor já deixa evidente seu significado.</p> <p>Reduzir a quantidade de coisa na barra de status me ajudou a focar no que é realmente relevante no momento. Para isso eu comecei a me questionar quais informações realmente eram importantes. Eu não me importo em qual rede wifi eu estou conectado na maior parte do tempo, mas eu tinha um bloco para isso (e é um bem comum), então eu só removi ele. E tem informações que só são relevantes às vezes, e é por isso que agora meus blocos ficam ocultos a não ser que a informação atual deles seja relevante.</p> <p>Eu também reduzi o número de atualizações inúteis dos blocos fazendo com que sempre que possível eles atualizassem com base em sinais ao invés de tempo. Então por exemplo o bloco de teclado apenas atualiza quando eu aperto o atalho de mudança do teclado, que manda um sinal para esse bloco.</p> <p>Ligar cada bloco a um sinal também faz com que os blocos atualizem mais rápidos para eventos assíncronos. Por exemplo, eu atualizo os pacotes no meu computador usando um comando, que além de atualizar usando o pacman, manda um sinal para o bloco de atualização no final. Então assim que eu acabo de atualizar os pacotes, esse bloco desaparece, e não depois de um certo tempo.</p> <p>Com o passar do tempo eu também escrevi um pouco de código para deixar as definições de blocos mais fáceis. Como outras partes do meu sistema, eu comecei meus blocos em bash, mas eventualmente migrei eles para python. Como parte disso eu escrevi uma função <code class="docutils literal">print_i3blocks</code> em python que recebe o ícone, texto e cor para o bloco e escreve eles na saída no formato JSON necessário para o i3blocks.</p> <p>Eu também tenho um comando <code class="docutils literal">update_i3blocks</code> que recebe o nome do bloco e envia o sinal correspondente, assim eu posso atualizar um bloco específico a partir de outros comandos no sistema.</p> </div> <div class="section" id="o-bug-irritante"> <h2>O bug irritante</h2> <p>Quando eu migrei os scripts dos blocos para python eu comecei a ter problemas com os blocos desaparecendo aleatoriamente. Levou quase um ano para realmente entrar no código do i3blocks e encontrar e <a class="reference external" href="https://github.com/vivien/i3blocks/pull/454">consertar esse problema</a>. Apesar de ter sido difícil de achar, foi muito interessante entender esse problema. Não tinha nada a ver com o python, é só que como código em python roda mais devagar que bash, ele ficou mais aparente.</p> <p>Infelizmente, já que o repositório do i3blocks não está mais ativamente mantido, se você estiver tendo esse mesmo problema e quiser consertá-lo, vai precisar aplicar o patch e compilar por si mesmo (apesar de ser bem simples). De qualquer forma eu não consigo nem dizer o quão feliz estou de finalmente ter me livrado desse bug. Agora eu posso simplesmente relaxar e aproveitar minha barra de status mostrando todas, e apenas, as informações que são relevantes para mim 🙂.</p> </div> Revivendo um computador no meio do nada2021-10-23T00:00:00-03:002021-10-23T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-10-23:/pt-br/post/revivendo-um-computador-no-meio-do-nada.html<p>No começo desse mês, eu estava passando umas semanas em outro país. Era tarde e eu estava mais uma vez olhando meus arquivos pessoais e pensando se havia uma forma melhor de organizá-los em pastas.</p> <p>Depois de pensar um pouco, eu decidi usar uma nova estrutura e movi alguns arquivos …</p><p>No começo desse mês, eu estava passando umas semanas em outro país. Era tarde e eu estava mais uma vez olhando meus arquivos pessoais e pensando se havia uma forma melhor de organizá-los em pastas.</p> <p>Depois de pensar um pouco, eu decidi usar uma nova estrutura e movi alguns arquivos. No meio tempo, eu percebi que eu não tinha atualizado meus pacotes já há algum tempo, então eu comecei uma atualização.</p> <p>No final da atualização eu vi um erro. O <code class="docutils literal">/etc/mkinitcpio.conf</code> não tinha sido encontrado. Meu <code class="docutils literal">/etc/mkinitcpio.conf</code> é um link simbólico para um arquivo na minha home já que isso torna mais fácil de acompanhar as mudanças nesse config como parte dos meus backups. E entre os arquivos que eu tinha acabado de mover estava justamente esse config, então eu atualizei o link para apontar para a nova localização. Eu rodei a atualização de novo e o <code class="docutils literal">pacman</code> reportou &quot;nothing to be done&quot;. Eu inocentemente acreditei que estava tudo certo agora.</p> <p>Então eu reiniciei para checar que estava tudo funcionando com os arquivos no novo lugar. Assim que eu selecionei meu sistema no GRUB, ele reportou que o <code class="docutils literal">/initramfs-linux.img</code> estava faltando. Mesma coisa para o initramfs de reserva (<em>fallback</em>). Eu estava oficialmente trancado para fora do meu sistema.</p> <p>Agora tinha ficado claro o que aconteceu. Durante a atualização o kernel foi atualizado, e como parte disso a initramfs foi re-gerada, mas já que o arquivo de configuração estava inválido, isso foi abortado. Quando eu rodei o comando de atualização novamente, o <code class="docutils literal">pacman</code> concluiu que nada mais precisava ser atualizado e assim disse. O que eu deveria ter feito é rodar manualmente o comando de instalação do pacote do kernel novamente para que a initramfs fosse de fato gerada. Como eu não fiz isso, não havia mais nenhum arquivo de initramfs na minha partição de boot, e portanto eu não conseguia inicializar o sistema.</p> <p>Eu respirei fundo e comecei a pensar o que eu podia fazer. Eu só precisava de um pendrive com a ISO do ArchLinux para bootar dele e rodar de novo a instalação do pacote de kernel para arrumar essa bagunça. Mas já que eu estava em outro país, meus equipamentos eram limitados. Felizmente eu tinha um pendrive, mas não tinha outro computador para gravar a ISO.</p> <p>A não ser... A não ser que eu pudesse usado meu amado celular Nexus 5X para gravar. A porta de carregamento dele é USB tipo C, e eu suspeitava que ela também funcionasse como OTG. Então eu tinha um pendrive e um cabo para conversão de USB A para C, só restava descobrir se era de fato possível gravar uma ISO do celular.</p> <p>Eu imediatamente abri a F-Droid e pesquisei por um gravador de ISO. Para minha felicidade encontrei o <a class="reference external" href="https://f-droid.org/en/packages/eu.depau.etchdroid/">EtchDroid</a>. Sua descrição realmente ressoou comigo: &quot;Você pode usá-lo para criar um pendrive bootável com GNU/Linux quando seu laptop está morto e você está no meio do nada.&quot; (tradução minha). Percebendo que talvez realmente fosse possível, eu fui na página do Arch Linux e baixei a ISO.</p> <p>Eu então instalei o EtchDroid e abri ele. Eu selecionei a opção de gravar uma ISO, selecionei o arquivo da ISO, conectei o pendrive no celular e selecionei ele no aplicativo. Eu realmente gostei da interface simples dele:</p> <img alt="{image}/etchdroid.png" src="/images/etchdroid/etchdroid.png" /> <p>Eu apertei o botão de iniciar a gravação e uma notificação apareceu mostrando o progresso:</p> <img alt="{image}/flash_in_progress.png" src="/images/etchdroid/flash_in_progress.png" /> <p>E depois de alguns segundos, tinha acabado:</p> <img alt="{image}/flash_done.png" src="/images/etchdroid/flash_done.png" /> <p>Eu então desconectei o pendrive do celular e conectei no meu notebook. Eu fiquei muito feliz de ver que a imagem USB tinha funcionado e bootei dela.</p> <p>Para consertar o problema eu configurei meus <em>mountpoints</em>, fiz um <em>chroot</em> para dentro do sistema, e rodei <code class="docutils literal">pacman -S linux</code> para reinstalar o pacote do kernel e a initramfs ser re-gerada.</p> <p>Com a initramfs de volta, eu reiniciei e tudo funcionou perfeitamente de novo 🙂.</p> <p>Eu estou muito feliz que apesar do meu erro besta, eu consegui resolvê-lo bem rápido mesmo em um ambiente limitado graças a esse excelente aplicativo chamado EtchDroid. Com certeza vou guardar ele para futuras emergências.</p> Minha jornada até um bom sistema de backup2021-09-27T00:00:00-03:002021-09-27T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-09-27:/pt-br/post/minha-jornada-ate-um-bom-sistema-de-backup.html<p>Eu confesso que sou um pouco acumulador de dados. Eu ainda tenho alguns dos primeiros programas que escrevi, fotos que tirei durante viagens e desenhos que fiz muitos anos atrás, para citar alguns exemplos. E já que eu não confio em alguma empresa para armazenar todos esses dados para mim …</p><p>Eu confesso que sou um pouco acumulador de dados. Eu ainda tenho alguns dos primeiros programas que escrevi, fotos que tirei durante viagens e desenhos que fiz muitos anos atrás, para citar alguns exemplos. E já que eu não confio em alguma empresa para armazenar todos esses dados para mim, já era bem claro que eu precisava fazer meus próprios backups.</p> <p>Uma lição que eu aprendi cedo lendo online é que backups devem ser o mais fácil possível de fazer, preferencialmente totalmente automáticos, se não você acaba nem fazendo eles.</p> <p>Nesse artigo eu quero relembrar meu sistema de backup anterior e então falar sobre o atual. Provavelmente até o final vai ficar claro que o atual é muito mais simples e melhor.</p> <div class="section" id="antigamente"> <h2>Antigamente</h2> <p>Eu acho que foi em 2018 que eu comecei a pensar seriamente sobre fazer backups. Para isso eu precisava tanto de hardware e software. O hardware para conter os backups e o software para fazê-los acontecer.</p> <div class="section" id="hardware"> <h3>Hardware</h3> <p>Eu tinha um computador de desktop que não funcionava mais devido a problemas na placa-mãe, mas todo o restante funcionava bem, então era o candidato perfeito para usar para o meu sistema de backup. O disco rígido poderia ser usado para armazenar os backups, a fonte para fornecer energia a tudo, e o gabinete para abrigar todos os componentes.</p> <p>Eu comecei removendo a placa-mãe que não funcionava mais e percebi que a fonte não fornecia nenhuma tensão por padrão. Pesquisando online pelo seu datasheet eu descobri quais fios precisavam ser curto-circuitados para que ela ligasse. Já que o botão de ligar no gabinete era um push button que conectava na placa-mãe, que por sua vez curto-circuitava esses fios, eu também removi esse botão e coloquei uma chave liga-desliga no lugar. Eu soldei a chave nos fios da fonte e grudei ela no gabinete com fita isolante e umas plaquinhas finas de metal que eu tinha sobrando para dar um pouco de rigidez. Ficou assim:</p> <img alt="{image}/button.jpg" src="/images/backup/button.jpg" /> <p>Quanto ao componente principal, o computador que faria os backups, eu tinha uma Raspberry Pi que não estava sendo usada então ela era a escolha óbvia. Eu peguei um conector micro USB de um cabo velho, abri o cabo, e soldei seus fios nos fios de 5V e terra da fonte. Assim, eu conseguiria energizar tudo pela mesma fonte, já que o disco rígido já era alimentado por ela.</p> <p>Finalmente, já que o disco rígido era interno, e portanto usava conexão SATA para transferir dados, eu comprei um cabo conversor SATA para USB baratinho e usei ele para conectar o disco na raspberry. A montagem completa fica assim:</p> <img alt="{image}/internals.jpg" src="/images/backup/internals.jpg" /> <p>(Essa é uma foto atual, na época a raspberry usava WiFi ao invés do cabo Ethernet)</p> <p>E com isso o hardware estava completo, o próximo passo era a solução de software para fazer os backups acontecerem.</p> </div> <div class="section" id="software"> <h3>Software</h3> <p>Nessa época em que eu estava pensando sobre qual software usar para os meus backups, eu esbarrei <a class="reference external" href="https://opensource.com/article/18/8/automate-backups-raspberry-pi">nesse artigo</a>. Ele me apresentou as ideias de backup incremental (apenas armazenar as diferenças dos arquivos do backup anterior) e rotação de backup (apenas armazenar os últimos N backups, deletando os mais antigos) que eu achei geniais. Ele também se baseava no rsync para as cópias, que era um programa com o qual eu já estava acostumado. No artigo um shell script é escrito para fazer o backup e a retenção, mas eu vi em um comentário mencionando que existia uma ferramente que fazia exatamente isso, chamada <a class="reference external" href="https://rsnapshot.org/">rsnapshot</a>. Então eu decidi usar rsync + rsnapshot como minha solução de backup.</p> <p>Em pouco tempo eu já comecei a me deparar com problemas. O maior deles era que o rsnapshot só consegue fazer backups para um armazenamento local. Isso significa que eu precisava rodar ele na raspberry, que estava conectada no disco rígido onde os backups iriam ficar, e de lá fazer backup dos arquivos do meu computador.</p> <p>Já que a raspberry precisava conectar no meu notebook, o normal a se fazer seria configurar um IP fixo nele, mas já que eu carregava ele comigo para outras redes, eu pensei que seria melhor mantê-lo com IP dinâmico. Então eu acabei com uma solução não-exatamente-elegante em que o meu notebook rodava o cronjob para o backup, no qual ele conectava à raspberry, atualizava seu IP nela, e rodava o rsnapshot nela. O rsnapshot então usava o IP atualizado para conectar de volta ao notebook e fazer o backup.</p> <p>Para tornar os dados seguros, o disco era criptografado usando dm-crypt. Portanto antes do rsnapshot começar o backup, o disco era desbloqueado usando a senha, que ficava salva como um arquivo no sistema da raspberry (eu sei, muito inseguro!). Depois do backup ele era bloqueado de novo e desligado.</p> <p>Outro problema era que o rsync não lida muito bem com renomeação ou mudança de arquivos/diretórios. Ele pensa que o anterior foi deletado e um novo foi criado. Isso era um grande problema já que eu estava sempre tentando achar a melhor hierarquia para os meus arquivos, o que significava renomear ou mover os diretórios base e de repente todos os meus arquivos precisavam ser copiados de novo...</p> <p>Esse problema era agravado ainda mais pelo fato de que a transferência entre o meu computador e a raspberry era feita sem fio, então era bem lenta. Para contornar esse problema eu adicionei um pouco de lógica nos scripts de backup para que se o tamanho total da transferência fosse muito grande, ela simplesmente falhava e me notificava. Então eu olhava no diff, lembrava que eu tinha renomeado alguns diretórios e copiava eles para o backup manualmente através de um cabo Ethernet temporário.</p> <p>Por fim, como a fonte era bem barulhenta e eu também não queria deixá-la ligada à toa, eu colocava um alarme diário no meu celular para me lembrar de apertar o botãozinho para ligá-la logo antes da hora do backup diário. E depois eu desligava antes de dormir.</p> </div> </div> <div class="section" id="atualmente"> <h2>Atualmente</h2> <p>Um bom tempo passou desde então, e já que aquele sistema funcionava mas estava longe de ser bom, eu pesquisei melhor sobre as ferramentas de backup que existem para ver se achava algo melhor. Tudo mudou quando eu descobri o <a class="reference external" href="https://www.borgbackup.org/">borg</a>.</p> <p><a class="reference external" href="https://www.borgbackup.org/">Borg</a>, ou BorgBackup, é um programa para fazer backups. Ele consegue fazer backups locais ou remotos. Os backups podem (e devem!) ser encriptados. E deduplicados! Eu não tenho certeza se renomear/mover arquivos fazem o backup levar mais tempo, mas no mínimo ele não vai ocupar mais espaço já que todos os arquivos são divididos em pequenos pedaços e deduplicados independentemente do caminho. Ah, e ele tem uma ótima documentação e uma comunidade ativa!</p> <p>Além disso, existe um outro projeto chamado <a class="reference external" href="https://torsion.org/borgmatic/">borgmatic</a>. O borgmatic permite que toda a configuração do uso do borg seja feita em um único arquivo, como os repositórios para usar, a política de retenção e os arquivos para ignorar. Então basicamente enquanto o borg fornece os comandos para fazer os backups, o borgmatic permite que tudo seja configurado em um único arquivo e ele cuida do resto.</p> <p>No fim, borg + borgmatic fazem ser incrivelmente fácil de ter backups seguros e confiáveis. Eu agora tenho uma única entrada simples no cron para fazer os backups diários: <code class="docutils literal">0 21 * * * cd ~/ &amp;&amp; borgmatic --no-color --verbosity 1 --files &gt;&gt; ~/ark/etc/bkplogs</code>. É importante notar que o borg sempre usa caminhos relativos nos backups, então por isso que eu dou <code class="docutils literal">cd</code> para a pasta onde os arquivos que eu quero salvar estão (meu diretório home).</p> <p>Além disso, como toda a minha configuração dos backups é feita em um único arquivo de configuração com o borgmatic, é fácil de fazer backup desse arquivo também. Então se algum dia eu perder meus arquivos e precisar recuperar do backup, eu vou imediatamente já ter a configuração do backup feita e pronto para continuar fazendo backups.</p> <p>Mas é, o borg é realmente ótimo e muito melhor do que todas as outras soluções que tentei antes. Tem um único detalhe, se você está fazendo backup para um repositório remoto, o borg também tem que rodar lá. Então nesses casos você vai ter um borg rodando na máquina local, fazendo a divisão dos arquivos em pedaços e criptografando (para que o remoto já receba as partes criptografadas e seja seguro!), e na máquina remota outra instância do borg vai estar recebendo eles e armazenando-os no repositório.</p> <p>Dada essa restrição, você não pode fazer backup para um armazenamento remoto simples na nuvem. Mas existem alternativas muito boas focadas em hospedar backups de borg, como o <a class="reference external" href="https://www.borgbase.com/">BorgBase</a>.</p> <p>Mas bem, eu ainda uso minha montagem da raspberry, só que agora eu instalei o borg lá ao invés do rsnapshot, e removi todos os meus scripts estranhos. Ele é agora apenas mais uma entrada no meu config do borgmatic. Fora isso, ao invés de ter a senha do disco simplesmente jogada no sistema da raspberry eu tive a ideia de enviá-la como parte do comando ssh da minha máquina, assim eu posso armazenar a senha de forma segura na minha própria máquina que é criptografada. Ah, e agora eu acabo fazendo os backups diários para um servidor remoto e apenas faço esses backups locais uma vez por semana, assim eu não tenho que ter o trabalho de apertar esse botãozinho todo dia 😉.</p> <p>Vale a pena mencionar que a recuperação de backups também é muito fácil com o borg. Existem dois comandos (oferecidos tanto pelo borg quanto pelo borgmatic): <code class="docutils literal">extract</code> e <code class="docutils literal">mount</code>. <code class="docutils literal">extract</code> recupera o(s) arquivo(s) de um dado <em>archive</em>. <strong>Note que ele vai ser salvo no mesmo caminho usado no archive, possivelmente sobrescrevendo seus arquivos locais</strong>, então melhor rodar ele dentro de uma pasta temporária primeiro. <code class="docutils literal">mount</code> monta o <em>archive</em> em uma pasta local como se fosse um sistema de arquivos, permitindo que você navegue pelos arquivos.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Como você pode ver, eu melhorei significativamente meu sistema de backup. E isso porque ele é menos interessante, não o contrário. Apesar de eu ter boas lembranças de ter meu próprio sistema, que dependia de múltiplos script para resolver os problemas com o que eu tinha, era um saco de manter. É ótimo ter tudo funcionando de cara com o borg e o borgmatic: Eu consigo até esquecer que eu estou fazendo backups agora, o que é um alívio.</p> </div> Domando meu Kindle2021-08-29T00:00:00-03:002021-08-29T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-08-29:/pt-br/post/domando-meu-kindle.html<p>Vários anos atrás minha mãe me deu um Kindle Paperwhite 2. Eu li alguns livros nele desde então, mas eu nunca senti que ele realmente era meu. Bloquear a tela mostrava um anúncio, todos os livros comprados da Amazon eram protegidos por DRM, livros transferidos via USB só funcionavam se …</p><p>Vários anos atrás minha mãe me deu um Kindle Paperwhite 2. Eu li alguns livros nele desde então, mas eu nunca senti que ele realmente era meu. Bloquear a tela mostrava um anúncio, todos os livros comprados da Amazon eram protegidos por DRM, livros transferidos via USB só funcionavam se estivessem no formato .mobi da Amazon, e eu sempre me sentia desconfortável sabendo que cada página que eu virasse podia estar sendo reportada de volta para a central deles.</p> <p>Recentemente eu decidi dar um basta nisso e descobrir como fazer jailbreak no meu Kindle. Eu estava disposto a torná-lo meu ou perdê-lo no processo.</p> <div class="section" id="fazendo-o-jailbreak"> <h2>Fazendo o Jailbreak</h2> <p>Depois de pesquisar um pouco achei <a class="reference external" href="https://www.mobileread.com/forums/showthread.php?t=320564">um artigo muito bem mantido em um fórum sobre como fazer jailbreak no Kindle</a>. Na verdade esse fórum mobileread.com inteiro parece ser o ponto focal de informações sobre fazer jailbreak e customizações em dispositivos de leitura de e-book. Eu acho incrível como existem essas bolhas na internet cheias de informações específicas e que você nunca encontra a não ser que procure por elas.</p> <p>Eu comecei a seguir o guia, que é na verdade bem simples: o jailbreak em si consiste em conectar o Kindle no computador pelo USB, adicionar um arquivo nele e fazer o arquivo rodar. Mas nesse momento eu percebi um grande problema que eu já suspeitava: o USB no meu Kindle não funcionava mais.</p> <p>A porta micro USB no Kindle serve tanto para transferência de energia, para carregar o dispositivo, quanto transferência de dados, para ser possível montar ele no computador como um dispositivo de armazenamento de dados e transferir arquivos. Mas de alguma forma a transmissão de dados não funcionava mais, então eu não conseguia enviar arquivos para o Kindle. Pelo menos a energia ainda funcionava, então eu ainda conseguia recarregar ele.</p> <p>Com o principal canal de dados para o Kindle quebrado, eu percebi que minhas alternativas eram ou descobrir o problema no USB, que eu imaginava que seria problema no hardware do controlador USB e precisaria trocar o CI por um novo, ou checar se o Kindle tinha uma interface UART funcional que eu poderia usar no lugar do USB. Essa segunda opção parecia bem mais fácil se fosse possível.</p> <div class="section" id="fazendo-o-jailbreak-pela-uart"> <h3>Fazendo o Jailbreak pela UART</h3> <p>De fato era possível acessar a UART do Kindle PW2 como <a class="reference external" href="https://www.mobileread.com/forums/showthread.php?t=267541">esse artigo</a> mostra. Ele também mostra como abrir o Kindle e dá algumas ideias de como tornar o acesso ao UART permanente.</p> <p>A única parte difícil em abrir foi o primeiro passo: fazer a tampa da frente desgrudar do resto. Tendo parado de tocar violão alguns anos atrás, eu nunca pensei que esse seria o jeito que uma palheta seria útil para mim de novo 😝:</p> <img alt="{image}/open-pick.jpg" src="/images/kindle-jailbreak/open-pick.jpg" /> <p>Com a ajuda da palheta eu desgrudei a tampa e depois de desparafusar alguns parafusos eu cheguei nas entranhas (a segunda foto mostra os parafusos da PCB também desparafusados e cabos flat desconectados já que eu estava fuçando, mas não tem nada de interessante debaixo da PCB):</p> <img alt="{image}/open-nocover.jpg" src="/images/kindle-jailbreak/open-nocover.jpg" /> <img alt="{image}/open-board.jpg" src="/images/kindle-jailbreak/open-board.jpg" /> <p>Nessa etapa eu já estava pronto para testar se a UART realmente funcionava. Um problema é que a UART do Kindle usa 1.8V e meu cabo UART é 3.3V. Para contornar esse problema eu usei um divisor de tensão para abaixar a tensão para o RX do Kindle, e dois transistores bipolares e um regulador de tensão de 3.3V para aumentar a tensão do TX do Kindle (tenho que admitir que eu pesquisei na internet por esse circuito, mas pelo menos depois que eu vi eu fui capaz de verificar como funcionava e vou lembrar dele para projetos futuros 🙂). Essa foi a configuração temporária:</p> <img alt="{image}/temp-mod-uart.jpg" src="/images/kindle-jailbreak/temp-mod-uart.jpg" /> <p>Com isso eu rodei o <code class="docutils literal">picocom</code> na porta serial e reiniciei o Kindle. Essa foi a saída que eu obtive (só pedaços para não ficar muito longo):</p> <pre class="code literal-block"> Terminal ready Battery voltage: 4072 mV Hit any key to stop autoboot: 0 ## Booting kernel from Legacy Image at 80800000 ... Image Name: Linux-3.0.35-lab126 Image Type: ARM Linux Kernel Image (uncompressed) Data Size: 3054728 Bytes = 2.9 MB Load Address: 80008000 Entry Point: 80008000 Verifying Checksum ... OK Loading Kernel Image ... OK OK Starting kernel ... [ 0.097278] boot: C def:bcut:batterycut=1 [ 0.274436] LPDDR2 MfgId: 0x1 [Samsung] [...] 3.0.35-lab126 #2 PREEMPT Wed Sep 25 00:44:40 UTC 2019 armv7l Press [ENTER] for recovery menu... 0 /BOOTING DEFAULT. IP-Config: no devices to configure kinit: Mounted root (ext3 filesystem) readonly. [...] info milestone:7.91:sy99:sy99 info system:done:time=7940:time=7940 crond[849]: crond (busybox 1.28.3) started, log level 8 init.exe: sshd main process (848) terminated with status 127 init.exe: sshd ain process endeinit.exe: recevnt pre-start proc Welcome to Kindle! kindle login: info milestone:8.24:sc01:sc01 info system_fs_loopbacks:mountingfs:Mounting compressed directories filesystem images:Mounting compressed directories filesystem images info milestone:8.27:sc02:sc02 info milestone:8.31:/usr/share/X11/xkb:/usr/share/X11/xkb [...] info clickstreamHeartbeatMetricsFramework:Skipping metrics recording, as it is the same day:: info monitor:writing_file:file=/var/run/upstart/stored.restarts:file=/var/run/upstart/stored.restarts Retrieved 383 keys for system/daemon/pmond/ </pre> <p>Opa, oi Linux 3.0, há quanto tempo você está aí? 🙂</p> <p>Enviar comandos pelo serial também estava funcionando, então eu estava pronto para seguir com o jailbreak. Eu continuei seguindo o <a class="reference external" href="https://www.mobileread.com/forums/showthread.php?t=267541">artigo sobre o jailbreak pelo serial</a> até que consegui root, mas para minha surpresa depois disso ele mostra como transferir o arquivo do jailbreak pelo armazenamento USB, que eu não posso usar. Mas já que consegui fazer o serial funcionar, eu não via porque não poderia usá-lo para transferir o arquivo, apesar de nunca ter feito isso antes.</p> <p>Mas claro que isso é possível, e descobri que é feito usando os protocolos de transferência de arquivos xmodem, ymodem ou modem. Todos eles são providos pelo pacote <a class="reference external" href="https://archlinux.org/packages/community/x86_64/lrzsz/">lrzsz</a> no Arch Linux. Já que o Kindle apenas possuía o binário do <code class="docutils literal">rx</code>, que é o receptor do xmodem, eu precisava usar o <code class="docutils literal">sx</code> no meu computador, para enviar usando o protocolo xmodem também.</p> <p>O procedimento para enviar um arquivo pelo serial usando o xmodem é:</p> <ul class="simple" id="procedimento-do-xmodem"> <li>rodar <code class="docutils literal">picocom</code> passando <code class="docutils literal">--send-cmd 'sx'</code>.</li> <li>no serial (o shell do Kindle no meu caso), digitar <code class="docutils literal">rx &lt;filename&gt;</code> onde <code class="docutils literal">filename</code> é o nome que vai ser dado para o arquivo recebido no sistema de arquivo destino.</li> <li>apertar <code class="docutils literal">Ctrl+a</code> seguido de <code class="docutils literal">Ctrl+s</code>. Isso vai instruir o picocom a enviar o arquivo, usando o <code class="docutils literal">sx</code> para a transferência já que foi ele que foi passado como o <code class="docutils literal">--send-cmd</code> na hora de rodar o picocom.</li> <li>no prompt que aparece, digitar o nome do arquivo que vai ser transferido da máquina origem, relativo ao diretório que o picocom foi executado.</li> <li>esperar a transferência terminar (pode levar um tempo).</li> </ul> <p>Vale ressaltar um detalhe importante em transferir arquivos dessa forma e que eu levei um tempo para descobrir, e que talvez seja específico da minha conexão com o Kindle, não tenho certeza, mas é que <strong>a transferência só vai funcionar se o Kindle estiver carregando</strong>. Por algum motivo, parece que quando ele não está carregando os sinais TX/RX não são estáveis o suficiente a ponto dos <em>checksum</em> que são enviados durante a transferência do xmodem não serem válidos e a transferência falha. Mas com o carregador conectado e seguindo os passos descritos acima, eu não tive nenhum problema em transferir arquivos. Usar o shell, por outro lado, funciona suficientemente bem mesmo sem ter o carregador conectado.</p> <p>A única coisa é que a transferência é demorada. A velocidade de transferência é aproximadamente 10 KB/s, então o arquivo de jailbreak (~160 KB) levou 15 segundos para transferir, já arquivos grandes como o pacote do KOReader (~37 MB), que vou mencionar logo abaixo, levou por volta de uma hora. Pelo USB o primeiro teria sido instantâneo, e o segundo teria levado alguns segundos. Isso me fez perceber o quanto evoluímos em velocidade de transferência, então esse método tem seu próprio charme 😝.</p> <p>Com essa configuração eu pude transferir o arquivo, seguir o restante do guia e completar o jailbreak do meu Kindle com sucesso! Eu também instalei o KUAL e o MRInstaller como sugerido nos guias para que pacotes sejam fáceis de instalar e possam ser acessados por uma GUI no Kindle.</p> </div> </div> <div class="section" id="tornando-ele-meu"> <h2>Tornando ele meu</h2> <p>Agora que eu tinha um Kindle com jailbreak era hora de finalmente torná-lo meu. A necessidade de usar o formato mobi é irritante, eu preferiria usar um formato mais padrão como o epub. Felizmente isso é possível em um Kindle com jailbreak usando a aplicação <a class="reference external" href="https://github.com/koreader/koreader">KOReader</a>.</p> <div class="section" id="koreader"> <h3>KOReader</h3> <p>O <a class="reference external" href="https://github.com/koreader/koreader">KOReader</a> é um leitor de e-book que roda em Kindles com jailbreak (e também outros dispositivos) e suporta múltiplos formatos de e-book como epub e pdf, que é exatamente o que eu queria.</p> <p>É sinceramente um ótimo programa: Ele é muito ativamente mantido e melhorado, e tem todas as funcionalidades que eu estava acostumado no leitor padrão do Kindle como marcar páginas, pesquisar no dicionário, pesquisar no texto e navegar pelos capítulos, além de muitas outras e diversas configurações dentro dos seus vários menus.</p> <p>Minhas funcionalidades preferidas, que são melhorias em relação ao leitor padrão do Kindle, são a barra de progresso na parte inferior da tela mostrando sua localização atual no livro, e o fato de que quando o dispositivo é bloqueado, a capa do livro é mostrada na tela! 😃 Isso me deixou muito feliz de ver. Sem mais anúncios ou imagens aleatórias da Amazon, só a capa do livro que eu estou lendo. Na verdade, eu originalmente tinha instalado o ScreenSavers Hack para ser possível colocar um bloqueio de tela logo depois que fiz o jailbreak no Kindle, mas depois que percebi que o KOReader já tinha essa funcionalidade embutida eu removi esse pacote.</p> <p>Minha única queixa com o KOReader é que às vezes ele fica bem lento, e então eu preciso reiniciá-lo (que leva só alguns segundos) e ele volta à velocidade normal. Mas eu provavelmente deveria atualizá-lo já que eles liberam uma nova versão todo mês e já fazem quatro meses desde que instalei, então esse problema pode já ter sido resolvido. (Sim, tudo descrito nesse artigo aconteceu por volta de abril)</p> </div> <div class="section" id="conector-uart"> <h3>Conector UART</h3> <p>A fim de tornar meu Kindle à prova de vigilância eu precisava manter o WiFi sempre desligado (também para manter o jailbreak funcionando). E já que transferir via USB não funciona mais, o UART seria minha única interface com o Kindle. Isso significa que eu preciso conseguir transferir os livros para o Kindle através do UART com certa facilidade. Eu não considero precisar abri-lo fácil o suficiente então eu precisava de um acesso ao UART mais definitivo.</p> <p>A ideia era basicamente fazer os fios conectados aos pontos de UART na PCB ficarem mais fixos, abrir um buraco na lateral da tampa de plástico do Kindle e expor alguns pinos ali para que fosse fácil conectar um cabo UART no Kindle sem precisar abri-lo.</p> <p>Um problema que já mencionei é que a tensão de operação do meu cabo UART é diferente da do Kindle, o que foi o motivo para eu ter feito o circuito conversor na protoboard. Eu inicialmente pensei em colocar o circuito conversor dentro do próprio Kindle, mas percebi que eu não tinha componentes pequenos o suficiente para que coubesse ali. Então no fim acabei aceitando que seria necessário um circuito conversor externo.</p> <p>A abertura na tampa para expor os pinos de serial foi feita pelo meu pai! 😃</p> <img alt="{image}/mod-case.jpg" src="/images/kindle-jailbreak/mod-case.jpg" /> <img alt="{image}/mod-case2.jpg" src="/images/kindle-jailbreak/mod-case2.jpg" /> <img alt="{image}/mod-case3.jpg" src="/images/kindle-jailbreak/mod-case3.jpg" /> <p>A solda dos fios nos pontos de UART da PCB foi um pouco complicada já que os pontos são bem pequenos. Mas com um pouco de ajuda de fita isolante para segurar o fio enquanto eu soldava e escolhendo um fio adequado (aqueles usados dentro de cabos Ethernet funcionaram bem) eu dei um jeito.</p> <p>Ainda sim eu estava preocupado em esbarrar no fio sem querer e desconectar ele, ou pior ainda, causar algum dano irreparável no ponto de UART, então eu acabei grudando os fios com fita isolante na placa a cada alguns centímetros, como <em>checkpoints</em>, e funcionou super bem. Eu vou certamente continuar usando essa técnica no futuro.</p> <img alt="{image}/mod-uart-connection.jpg" src="/images/kindle-jailbreak/mod-uart-connection.jpg" /> <p>Eu deixei um pouco de fio sobrando caso seja necessário no futuro.</p> <img alt="{image}/mod-uart-wires.jpg" src="/images/kindle-jailbreak/mod-uart-wires.jpg" /> <p>Fazer o fio ficar bem conectado nos pinos do conector foi complicado também. Eu torci cada fio em volta de cada pino, mas não tão apertado para que o fio não quebrasse (isso aconteceu algumas vezes), e adicionei um pouco de solda. Depois disso eu coloquei fita isolante em volta de cada pino para que os fios de cada pino não tocassem um ao outro. Por fim adicionei mais fita isolante em volta de todos os pinos para isolar eles do corpo cinzento do Kindle, já que ele é um material condutor.</p> <img alt="{image}/mod-uart-header.jpg" src="/images/kindle-jailbreak/mod-uart-header.jpg" /> <p>Depois de centralizar razoavelmente os pinos no buraco, eu coloquei a <a class="reference external" href="https://www.loctite-consumo.com.br/pt/produtos/durepoxi.html">durepoxi</a> e moldei ela em volta dos pinos, em cima e embaixo, para que ficassem bem fixos no corpo do Kindle.</p> <img alt="{image}/mod-uart-epoxy.jpg" src="/images/kindle-jailbreak/mod-uart-epoxy.jpg" /> <p>Depois de deixar secar durante a noite, a cirurgia estava completa:</p> <img alt="{image}/mod-final.jpg" src="/images/kindle-jailbreak/mod-final.jpg" /> <p>Ah, e eu fiz tudo isso duas vezes. A primeira vez eu cheguei até o fim e só então percebi que dois dos pinos estavam curto circuitados pelo corpo cinzento do Kindle. Felizmente a durepoxi não estava totalmente rígida ainda então eu consegui removê-la com um pouco de perseverança e tentar de novo.</p> </div> </div> <div class="section" id="resultado"> <h2>Resultado</h2> <p>Então agora eu tenho um Kindle com os pinos UART expostos, e foi assim que ficou:</p> <img alt="{image}/result-pin.jpg" src="/images/kindle-jailbreak/result-pin.jpg" /> <img alt="{image}/result-front.jpg" src="/images/kindle-jailbreak/result-front.jpg" /> <p>Agora quando eu quero ler um novo livro, eu conecto o carregador e a placa conversora nele (eu ainda estou usando a protoboard para o circuito conversor porque ainda não superei a preguiça para fazer uma placa decente, mas não seria difícil e seria bem mais compacta):</p> <img alt="{image}/result-transfer-setup.jpg" src="/images/kindle-jailbreak/result-transfer-setup.jpg" /> <p>Aí eu sigo o <a class="reference internal" href="#procedimento-do-xmodem">procedimento do xmodem</a> que mencionei acima para enviar o arquivo do livro pelo UART e espero um pouco até a transferência acabar...</p> <pre class="code literal-block"> [root&#64;kindle documents]# rx sherlock_holmes.epub C *** file: ext/books/sherlock_holmes.epub $ sx ext/books/sherlock_holmes.epub Sending ext/books/sherlock_holmes.epub, 16078 blocks: Give your local XMODEM receive command now. Bytes Sent:2058112 BPS:10396 Transfer complete *** exit status: 0 *** [root&#64;kindle documents]# </pre> <p>Esse livro levou 3 minutos para transferir. O tamanho padrão de livros epub é entre 100 KB e 10 MB, então a transferência leva entre 10 segundos e 20 minutos dependendo do livro. É significantemente mais tempo do que levaria por USB (alguns segundos) mas já que eu levo entre um e dois meses para acabar de ler cada livro acaba não sendo um problema.</p> <p>Quando a transferência termina, tudo que resta é desconectar os cabos e aproveitar a leitura! 🙂</p> <img alt="{image}/result-book.jpg" src="/images/kindle-jailbreak/result-book.jpg" /> <p>(Eu uso essa capa azul no Kindle para protegê-lo, e os pinos são curtos o suficiente que eles cabem embaixo também)</p> <p>Obs: Esse livro está disponível em domínio público e pode ser <a class="reference external" href="https://www.gutenberg.org/ebooks/48320">baixado de graça no Project Gutenberg</a>.</p> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Deu um pouco mais de trabalho do que eu esperava inicialmente, mas depois disso tudo eu estou feliz que finalmente realmente sou o dono do meu Kindle e posso ter uma experiência de leitura melhor nele 🙂.</p> </div> Customizações do blog2021-07-24T00:00:00-03:002021-07-24T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-07-24:/pt-br/post/customizacoes-do-blog.html<p>Eu tenho usado o <a class="reference external" href="https://github.com/getpelican/pelican/">pelican</a> como meu gerador de blog estático desde que comecei esse blog um pouco mais de um ano atrás. Só precisou de um pouco de configuração para ter o blog funcionando, e um pouco de pesquisa no <a class="reference external" href="http://pelicanthemes.com/">pelicanthemes</a> para achar o <a class="reference external" href="https://github.com/gunchu/nikhil-theme">nikhil-theme</a> que é o tema …</p><p>Eu tenho usado o <a class="reference external" href="https://github.com/getpelican/pelican/">pelican</a> como meu gerador de blog estático desde que comecei esse blog um pouco mais de um ano atrás. Só precisou de um pouco de configuração para ter o blog funcionando, e um pouco de pesquisa no <a class="reference external" href="http://pelicanthemes.com/">pelicanthemes</a> para achar o <a class="reference external" href="https://github.com/gunchu/nikhil-theme">nikhil-theme</a> que é o tema que eu ainda uso.</p> <p>Apesar da configuração base do blog ter sido fácil, ela não ficou perfeitamente adequada para o meu uso. Foi aí que eu comecei a customizar algumas coisas para deixar o blog sob medida para mim. Felizmente o pelican é <a class="reference external" href="https://docs.getpelican.com/en/stable/index.html">muito customizável</a>, a ponto de oferecer uma interface para plugins além das configurações normais. Ele também é escrito em python, então se tudo der errado, sempre existe a alternativa de hackear um patch para fazer o serviço 😝.</p> <p>Então como prometido no artigo anterior, nesse eu vou falar sobre as principais customizações que eu fiz no meu blog até o momento. Ao longo do texto eu vou referenciar os commits em que eu fiz as mudanças mencionadas aqui.</p> <div class="section" id="customizacoes"> <h2>Customizações</h2> <div class="section" id="plugins-do-pelican"> <h3>Plugins do pelican</h3> <p>As customizações que tiveram mais impacto foram provavelmente os plugins de pelican que eu adicionei. Eles não são minhas modificações, mas dada sua importância eu quero mencioná-los mesmo assim.</p> <p>Os dois plugins que eu estou usando atualmente são <a class="reference external" href="https://github.com/getpelican/pelican-plugins/tree/master/i18n_subsites">i18n_subsites</a> e <a class="reference external" href="https://github.com/pelican-plugins/series">series</a>, e foram bem fáceis de encontrar pelo <a class="reference external" href="https://github.com/getpelican/pelican-plugins/">repositório de plugins</a>.</p> <p>O i18n_subsites é ótimo para o meu blog com idioma duplo. Por padrão o pelican suporta apenas traduzir artigos do blog como textos independentes, de forma que cada artigo que tenha sido traduzido possui links para as traduções. Mas o que eu realmente queria era ter duas versões do meu blog, uma em inglês e outra em português. Cada uma com toda a interface na sua própria língua além de apenas mostrar os artigos dessa língua. Esse plugin possibilita exatamente isso.</p> <p>É um pouco confuso de entender como configurar corretamente no começo, principalmente a <a class="reference external" href="https://github.com/getpelican/pelican-plugins/blob/master/i18n_subsites/localizing_using_jinja2.rst">parte de localização do template</a>, mas bom, eu aprendi sobre Jinja2 e gettext! Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/f538d7ebf78f9b93dd046d6aa44eaae08b287b66">1</a> (foi parte do commit inicial...), <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/9a02ff6bd640ea3c79e9e66f72b68116bed17b38">2</a>, <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/604ca272908e77d50bc459ba51f45e47fbfb30bd">3</a>, <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/c2effc722cf01b834c7f2373bd6ef8791e4adc7d">4</a> e <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/d23b1151f12db58a9f9b4bbdbd9389cf6fdf53e4">5</a>.</p> <p>O series eu adicionei um pouco depois. Ele é muito simples mas útil. A propósito você pode vê-lo em ação nesse mesmo artigo no topo. Ele é o que me permite fazer esse artigo ser parte de uma série de artigos, com link para os outros. Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/b6f481df611fa1b2e0815e2eeaf2b0a7a8016f26">1</a>.</p> </div> <div class="section" id="feed-rss-separado-para-cada-sub-site-i18n"> <h3>Feed RSS separado para cada sub-site i18n</h3> <p>Ainda no tema de tradução, já que eu queria sub-sites separados para cada idioma, também fazia sentido ter um feed RSS para cada um deles. No fim isso acabou sendo uma mudança de uma única linha, apesar de ter demorado um pouco para eu descobrir como fazer isso. Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/dee307122f54e04f9aaa5a203b29a9c029a5f88f">1</a>.</p> </div> <div class="section" id="deteccao-automatica-do-idioma-pelo-nome-do-arquivo"> <h3>Detecção automática do idioma pelo nome do arquivo</h3> <p>Outra customização relacionada a tradução (foi algo bem importante pro meu blog! 😝) foi a configuração automática do idioma de um artigo com base no nome do arquivo. Já que eu já quero que o arquivo para cada tradução de um artigo tenha o idioma em seu nome, isso me poupa de ter que adicionar o cabeçalho de idioma também.</p> <p>Por exemplo, os arquivos para este artigo são chamados <code class="docutils literal">07-blog-custom-en.rst</code>, para a versão em inglês, e <code class="docutils literal">07-blog-custom-br.rst</code> para a versão em português. Normalmente eu também precisaria configurar o cabeçalho de metadados <code class="docutils literal">lang</code> para cada um com o idioma correspondente, mas com essa mudança ele é configurado automaticamente 🙂. Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/f538d7ebf78f9b93dd046d6aa44eaae08b287b66#4cd8c938f4dfb9b2579dcfaf97c623df6ca28eb8_0_23">1</a> (de novo, parte do commit inicial 😅) e <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/1712f5b44b2d51de410348462c9d8a66d8b210fa">2</a>.</p> </div> <div class="section" id="configuracao-de-icone-para-paginas"> <h3>Configuração de ícone para páginas</h3> <p>Quando eu estava configurando a barra de navegação no topo, eu queria adicionar um ícone para cada item, para deixar bem claro o que cada um faz. Mas a página Sobre, diferentemente dos outros, é uma página gerada do fonte (assim como os artigos) e adicionada automaticamente à barra, então não é possível configurar seu ícone direto no HTML.</p> <p>Para resolver isso eu criei um cabeçalho de metadado customizado <code class="docutils literal">icon</code> que armazena o nome do ícone FontAwesome que será mostrado na barra para a página. Aí eu apenas adicionei o nome daquele ícone de &quot;círculo de informação&quot; para a página Sobre e a aparência ficou bem melhor 🙂. Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/76534d397a83117327aa1381241b412c77a47b7b">1</a>.</p> </div> <div class="section" id="conserto-da-renderizacao-de-literal-no-rst"> <h3>Conserto da renderização de literal no rst</h3> <p>Vamos finalizar o artigo com a maior mudança 😝.</p> <p>Primeiro de tudo, um pouco de contexto: Quando eu comecei o blog, eu escrevia meus artigos em Markdown. Mas alguns meses depois eu conheci o <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a> (daqui para frente, chamado de rst) porque ele era usado na documentação do Kernel Linux, e comecei a usar mais ainda quando descobri o <a class="reference external" href="https://rst2pdf.org/">rst2pdf</a>, que eu não vou entrar em detalhes já que ainda pretendo escrever sobre ele eventualmente. O ponto é que eu passei a escrever os meus artigos em rst já que ele também é suportado pelo pelican.</p> <p>Mas um problema muito irritante que eu enfrentei foi que o gerador HTML padrão do rst traduz blocos literais para tags <code class="docutils literal">&lt;tt&gt;</code>. Essa tag foi descontinuada no HTML5, e o mundo inteiro usa <code class="docutils literal">&lt;code&gt;</code> para código no meio do texto, incluindo meu tema, o que significa que literais não eram renderizados corretamente. (<a class="reference external" href="https://sourceforge.net/p/docutils/mailman/docutils-develop/thread//p/docutils/bugs/393/de24b5cc7539766427b108223bbcedb8ea8aef5f.bugs%40docutils.p.sourceforge.net/#msg37057965">Existem motivos</a> para o rst não usar <code class="docutils literal">&lt;code&gt;</code> para literais, mas para o meu blog eles não são relevantes)</p> <p>Eu poderia ter simplesmente adaptado meu tema para contornar esse problema, mas isso seria apenas escondê-lo: A tag descontinuada <code class="docutils literal">&lt;tt&gt;</code> continuaria ali para todo o mundo ver.</p> <p>Em um primeiro momento, eu contornei esse problema usando o <em>role</em> <code class="docutils literal">code</code> explicitamente:</p> <pre class="literal-block"> O seguinte é um literal no rst, então ficará dentro de uma tag &lt;tt&gt;: ``bla`` O seguinte usa o role 'code', então ficará dentro de uma tag &lt;code&gt;: :code:`bla` </pre> <p>Essa é claramente uma sintaxe muito extensa para um blog que frequentemente usa código no meio do texto, então eu me cansei rapidamente dela. Eu comecei então a redefinir o <em>role</em> padrão para ser <code class="docutils literal">code</code>, e a usar um único símbolo de crase ao invés dos dois que se usa para literais:</p> <pre class="literal-block"> .. default-role:: code Agora o seguinte vai usar o role 'code': `bla` </pre> <p>Já que o texto está entre um único símbolo de crase de cada lado mas não possui um <em>role</em> especificado, ele usará o padrão. Muito melhor, mas eu ainda precisava escrever aquela definição de <code class="docutils literal">default-role</code> no começo de cada documento...</p> <p>Finalmente, eu pensei em uma solução ainda melhor: Criar um plugin de leitor de rst para o pelican que modifique o leitor padrão apenas quando estiver lidando com literais, para que a saída seja <code class="docutils literal">&lt;code&gt;</code> ao invés de <code class="docutils literal">&lt;tt&gt;</code>.</p> <p>Honestamente isso foi mais fácil do que eu esperava. Só precisou copiar um pouco dos leitores do pelican e do Sphinx e funcionou perfeitamente! Agora eu finalmente conseguia escrever literais usando a sintaxe padrão do rst e ver eles renderizados como <code class="docutils literal">&lt;code&gt;</code> no HTML sem nenhum trabalho a mais 🙂. Commits relevantes: <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/5349ef680c32f124cc425699749498f5debda0a1">1</a> e <a class="reference external" href="https://codeberg.org/nfraprado/blog/commit/bfb15a96a09ef7dd3403b9ed3e29f89a2a743731">2</a> (esse é apenas eu atualizando todos os textos do blog para usar a nova sintaxe).</p> </div> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Com essas customizações, eu tenho um blog em que me sinto bastante confortável, tanto para escrever quanto para ler. Essas mudanças que eu mostrei aqui foram as que eu achei mais interessantes, mas claro que <a class="reference external" href="https://codeberg.org/nfraprado/blog">todo o código é aberto</a>, então fique à vontade para ver o resto.</p> </div> Um ano de blog2021-06-22T00:00:00-03:002021-06-22T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-06-22:/pt-br/post/um-ano-de-blog.html<p>Faz um ano que eu comecei esse blog! Pensei em aproveitar a oportunidade para falar um pouco sobre o blog em si: Como começou e meus pensamentos sobre ele.</p> <div class="section" id="origem"> <h2>Origem</h2> <p>Eu já tinha pensado em pouco sobre ter meu próprio blog. Ter um cantinho da internet onde eu fosse livre …</p></div><p>Faz um ano que eu comecei esse blog! Pensei em aproveitar a oportunidade para falar um pouco sobre o blog em si: Como começou e meus pensamentos sobre ele.</p> <div class="section" id="origem"> <h2>Origem</h2> <p>Eu já tinha pensado em pouco sobre ter meu próprio blog. Ter um cantinho da internet onde eu fosse livre para falar sobre coisas que me interessam parecia bem legal. E quem sabe outras pessoas também achariam elas interessantes!</p> <p>Mas eu não tenho interesse nenhum em desenvolvimento web, então eu só queria escrever meus artigos sem precisar lidar com isso. Isso parecia apontar para geradores de site prontos para uso como o WordPress, mas eu também não gostava dessa ideia.</p> <p>Felizmente, já existia uma certa tendência a usar geradores de site estático. Eles eram rápidos, simples de usar e você podia versionar o fonte no git e hospedar o site de graça usando Gitlab/Github! Assim que eu soube da existência deles eu sabia que era isso que eu queria.</p> <p>Na época dois dos meus amigos já tinham seus próprios blogs (<a class="reference external" href="https://rafaelg.net.br">https://rafaelg.net.br</a> e <a class="reference external" href="https://andrealmeid.com">https://andrealmeid.com</a>) usando geradores de site estático e eles me encorajaram a criar o meu também. Um deles me introduziu ao <a class="reference external" href="https://github.com/getpelican/pelican/">pelican</a>, um gerador de blog estático em python e eu decidi experimentar ele.</p> <p>Depois de escolher um tema e um pouco de customização no pelican (que eu vou falar sobre no próximo artigo), eu estava pronto para começar a escrever. E foi então que eu comecei o blog com o <a class="reference external" href="/pt-br/post/criando-listas-de-filmes-e-jogos-usando-taskwarrior.html">artigo "Criando listas de filmes e jogos usando Taskwarrior"</a>, que é divertidamente pessoal, e ainda sim técnico. Eu gosto desse estilo 🙂.</p> <p>Então foi assim que o blog começou. Agora eu queria ir um pouco mais a fundo nos princípios que guiam o blog.</p> </div> <div class="section" id="principios"> <h2>Princípios</h2> <p>Existem duas coisas que eu acho que são bem importantes sobre o jeito que o blog funciona: o idioma duplo e o formato de diário aberto.</p> <div class="section" id="idioma-duplo"> <h3>Idioma duplo</h3> <p>Você deve ter notado que todos os artigos no meu blog têm um campo de &quot;traduções&quot; com um outro idioma. E também há um botão para mudar o idioma na barra de navegação. O motivo é que o meu blog está disponível tanto em inglês quanto em português brasileiro. Para tornar isso possível eu traduzi a interface para português e, mais importante, escrevo cada artigo tanto em inglês quanto em português.</p> <p>A interface foi bem fácil de traduzir, mas precisar escrever cada artigo praticamente duas vezes é bastante trabalho a mais. Então por que eu faço isso?</p> <p>Quando eu estava pensando em criar o blog, eu me deparei com um dilema: em qual idioma deveria escrever?</p> <p>Por um lado, escrever em inglês faria meu conteúdo amplamente disponível, já que é, na prática, a língua da internet. Seria possível por exemplo compartilhar um artigo com uma comunidade com a qual eu contribuí.</p> <p>Por outro lado, eu gosto da minha língua. E eu queria poder compartilhar meus artigos com pessoas que eu conheço pessoalmente sem um barreira invisível: quando tanto eu quanto a pessoa somos mais familiares com português, parece sem sentido transmitir a informação em inglês. Eu também não queria alienar pessoas, do meu próprio país, que não falam inglês (apesar disso ser cada vez mais raro).</p> <p>Então eu decidi escolher os dois 🙂. O dobro do trabalho, mas nenhuma das desvantagens e o dobro das vantagens. Na verdade não é o dobro do trabalho, já que o segundo artigo é basicamente a tradução do outro e não um artigo do zero. O fato de eu não publicar tão frequentemente (uma vez por mês) também ajuda.</p> </div> <div class="section" id="formato-de-diario-aberto"> <h3>Formato de diário aberto</h3> <p>Outra coisa é a forma que eu lido com meus artigos, e minha motivação. Ou a resposta à pergunta: Já existe um zilhão de blogs por aí, por que alguém iria querer ler o meu? Realmente vale a pena ter um blog?</p> <p>E minha resposta para isso é: Sim, vale, porque eu não estou escrevendo para os outros.</p> <p>A principal razão de eu escrever no meu blog é porque eu quero registrar os projetos que eu fiz e as coisas que eu achei interessantes, para que no futuro eu possa olhar para trás e relembrar deles. Então é basicamente um diário (só que mensal).</p> <p>Mas claro que se qualquer pessoa estiver interessada em qualquer um dos assuntos, ela é livre para ler, o que torna o blog mais como um diário aberto. Bem legal se acontecer, mas eu não conto com isso. Eu escrevo para mim mesmo, mas se outras pessoas gostarem é um ótimo bônus 🙂.</p> <p>Esse é o motivo de eu não costumar fazer tutoriais. Ao invés disso documento minha experiência no aprendizado ou construção de algo. Tem um quê bem mais pessoal, apesar de não ser tão acessível.</p> <p>(Agora que eu escrevi esses dois princípios eu percebi que eles são um pouco contraditórios, mas fazer o que, é como eu me sinto. Eu sou humano afinal de contas 😛.)</p> <p>Já que eu estava tratando meu blog como um diário fazia sentido para mim tentar escrever com uma frequência fixa. Eu acabei decidindo escrever uma vez por mês já que era o suficiente para me manter engajado mas não demais a ponto de me estressar.</p> <p>Eu também acabei estabelecendo o dia 20 do mês como a data alvo. Isso é só uma diretriz. Eu não me forço nada disso. Se eu não estiver disposto a publicar nesse mês ou se não conseguir a tempo do dia 20, tudo bem. Mas estabelecer esse prazo opcional cria uma pressão saudável para que eu vença a preguiça e pense se alguma coisa interessante que eu queira compartilhar (com meu eu do futuro e com outras pessoas) aconteceu recentemente.</p> <p>Isso tem funcionado muito bem até agora. Eu sinto que eu sempre tive algo interessante para compartilhar, e de fato eu publiquei todos os meses até o momento, só me atrasei algumas vezes com relação ao dia 20 (inclusive para este artigo 😝). Me limitando a um único artigo por mês eu também acabo criando um acúmulo de artigos para publicar, apesar de geralmente faltar alguma coisa neles antes de poderem ser publicados (eu tenho pelo menos três nessa situação neste momento).</p> </div> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Então, em resumo, tem sido uma jornada bem legal até agora. Eu estou feliz de já ter acumulado 13 artigos (14 contando este) que eu posso rever no futuro e ficar nostálgico pelas coisas que eu construí ou aprendi, e quem sabe até ter novas ideias para projetos futuros!</p> <p>Eu não sei até quando isso aqui vai continuar, mas por enquanto eu não vejo um fim 🙂.</p> <p>E é isso sobre o lado &quot;humano&quot; do blog. No próximo artigo eu vou falar sobre o lado técnico: as customizações que eu fiz no blog ao longo desse ano para suprir minhas necessidades.</p> </div> Gerenciando meus pacotes2021-05-20T00:00:00-03:002021-05-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-05-20:/pt-br/post/gerenciando-meus-pacotes.html<p>Como eu mencionei anteriormente no <a class="reference external" href="/pt-br/post/mudando-para-o-wayland.html">artigo "Mudando para o Wayland"</a>, eu recentemente mudei de computador. Mudanças podem ser bem trabalhosas se você usa um sistema muito customizado e não tem todas as configurações facilmente disponíveis para fazer a mudança. Já que eu faço backup dos meus arquivos, que inclui uma …</p><p>Como eu mencionei anteriormente no <a class="reference external" href="/pt-br/post/mudando-para-o-wayland.html">artigo "Mudando para o Wayland"</a>, eu recentemente mudei de computador. Mudanças podem ser bem trabalhosas se você usa um sistema muito customizado e não tem todas as configurações facilmente disponíveis para fazer a mudança. Já que eu faço backup dos meus arquivos, que inclui uma pasta <code class="docutils literal">dotfiles</code> com todos (ou quase todos) os arquivos de configuração para os programas que eu uso, eu pensei que seria bem simples.</p> <p>Mas durante a mudança, eu percebi que eu não tinha um jeito fácil de ver e instalar todos os programas que eu uso. Nesse momento eu comecei a pensar em usar uma distro como o <a class="reference external" href="https://nixos.org/">NixOS</a> que usa um gerenciador de pacotes declarativo justamente para tornar fácil reproduzir um sistema. Mas eu gosto bastante do <a class="reference external" href="https://archlinux.org/">Arch Linux</a>, e sinceramente não existe nenhuma razão para eu não poder ter essa funcionalidade nele.</p> <div class="section" id="gerenciamento-de-pacotes-declarativo"> <h2>Gerenciamento de pacotes declarativo</h2> <p>O objetivo então era ter um gerenciamento de pacotes declarativo para tornar mudanças futuras mais fáceis. Inclusive, como nesse método os pacotes são listados em um arquivo, com o versionamento dele nos meus backups eu também ganho de brinde a possibilidade de voltar para um versão anterior (se eu quiser reverter algum erro na lista de pacotes, por exemplo).</p> <p>Mas ter uma simples lista dos pacotes instalados não é a melhor coisa sobre o gerenciamento de pacotes declarativo. O maior benefício é que você pode <em>organizar</em> essa lista de uma forma que faça sentido para você, reordenando e agrupando os pacotes conforme necessário. E você pode deixar comentários pelo arquivo inteiro, que é útil principalmente para registrar a razão de ter instalado cada pacote, assim você pode usar essas informações para remover os pacotes que não são mais necessários.</p> <p>Uma busca rápida na internet por gerenciadores de pacotes declarativos para o Arch Linux revelaram o <a class="reference external" href="https://github.com/CyberShadow/aconfmgr">aconfmgr</a> e o <a class="reference external" href="https://github.com/rendaw/decpac">decpac</a>. O primeiro é mais completo, contendo também gerenciamento de configurações integrado, mas isso já é demais para mim, e ele é em bash, então ponto negativo. O segundo é bem simples, você basicamente tem apenas um arquivo com os comandos para instalar os pacotes e os pacotes em si em uma sintaxe parecida com JSON. E é em python.</p> <p>O decpac também permite instalar do <a class="reference external" href="https://aur.archlinux.org/">AUR</a> através do uso da ferramenta <a class="reference external" href="https://github.com/Jguer/yay">yay</a>. Os pacotes do AUR são identificados por uma marcação simples antes do nome do pacote.</p> <p>O decpac é <em>quase</em> perfeito, mas eu não gostei que ele usa o mesmo arquivo tanto para a configuração dos comandos quanto para a lista de pacotes, porque isso faz com que a sintaxe precise ser mais complexa, e ela é similar a JSON mas não exatamente.</p> <p>E foi por isso que eu decidi criar o meu próprio, que eu chamei, bem criativamente, de pcmn.</p> </div> <div class="section" id="pcmn"> <h2>pcmn</h2> <p>O <a class="reference external" href="https://codeberg.org/nfraprado/pcmn">pcmn</a> é bem simples, com menos de 200 linhas de código em python. Ele é bastante inspirado no decpac com a principal diferença sendo a sintaxe mais simples. E é bem simples mesmo:</p> <ul class="simple"> <li>um pacote por linha (mas linhas sem nenhum pacote são permitidas também, claro)</li> <li>tudo depois de um <code class="docutils literal">#</code> é um comentário</li> <li>opcionalmente o grupo do pacote pode ser escrito entre colchetes antes do nome do pacote. Quando nenhum grupo é especificado, o padrão é assumido, que instala do repositório oficial. O único outro grupo é <code class="docutils literal">aur</code>, que informa que o pacote deve ser instalado do AUR usando o yay.</li> </ul> <p>Só existem dois comandos:</p> <ul class="simple"> <li><code class="docutils literal">generate</code> cria uma nova lista de pacotes com base nos pacotes atualmente explicitamente instalados (ou seja, as dependências não vão aparecer na lista, mas não é problema porque o pacman vai resolvê-las).</li> <li><code class="docutils literal">apply</code> aplica a lista de pacotes, ou seja, pacotes não listados são desinstalados e pacotes na lista que não estiverem presentes são instalados.</li> </ul> <p>Um arquivo de configuração separado em JSON pode ser usado para mudar os comandos usados para listar, instalar e remover os pacotes, tanto para o grupo padrão quanto para o <code class="docutils literal">aur</code>.</p> <p>Eu estou usando ele faz alguns meses já e estou bem satisfeito. Como eu mencionei, a principal diferença do decpac é que eu separei a configuração e a lista de pacotes e eu acho que isso fez toda a diferença. A lista de pacotes é bem limpa e fácil de adicionar itens. Esse é um pedaço da minha:</p> <pre class="code python literal-block"> <span class="c1">#</span><span class="w"> </span><span class="c1"># Utilities</span><span class="w"> </span><span class="c1">#</span><span class="w"> </span><span class="c1"># Backups</span><span class="w"> </span><span class="n">borg</span><span class="w"> </span><span class="n">borgmatic</span><span class="w"> </span><span class="n">python</span><span class="o">-</span><span class="n">llfuse</span> <span class="c1"># Needed to mount an archive</span><span class="w"> </span><span class="c1"># Notifications</span><span class="w"> </span><span class="n">libnotify</span><span class="w"> </span><span class="n">mako</span><span class="w"> </span><span class="c1"># Keyboard (Custom)</span><span class="w"> </span><span class="n">interception</span><span class="o">-</span><span class="n">caps2esc</span> <span class="c1"># Switch Caps with ESC</span><span class="w"> </span><span class="p">[</span><span class="n">aur</span><span class="p">]</span> <span class="n">interception</span><span class="o">-</span><span class="n">space2meta</span> <span class="c1"># Use Space as Meta</span> </pre> <p>Toda vez que eu percebo que preciso de algum pacote a mais para alguma coisa eu adiciono na lista, coloco um comentário sobre o motivo, e rodo <code class="docutils literal">pcmn apply</code> para ele ser instalado. Quando vou instalar um pacote temporariamente só para fazer algo bem rápido ou algum teste, eu instalo manualmente com o pacman mesmo, assim da próxima vez que fizer um <code class="docutils literal">apply</code> ele já é desinstalado.</p> <p>Se você achou o pcmn interessante, dê uma olhada <a class="reference external" href="https://codeberg.org/nfraprado/pcmn">no repositório dele</a> para um pouco mais de informação. Ele também é facilmente instalável <a class="reference external" href="https://aur.archlinux.org/packages/pcmn-git/">do AUR</a>, o que significa que depois de você fazer gerar a lista de pacotes com <code class="docutils literal">generate</code>, <code class="docutils literal">[aur] pcmn-git</code> vai aparecer na lista de pacotes que ele mesmo gerencia. Eu acho isso engraçado por algum motivo 😝.</p> <p>E é por isso que eu gosto tanto de python. Com menos de 200 linhas de código eu escrevi um programa que resolve um problema real que eu estava tendo. <a class="reference external" href="https://xkcd.com/353/">E também foi divertido de escrever!</a></p> </div> Aprendendo teoria musical escrevendo melodias2021-04-20T00:00:00-03:002021-04-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-04-20:/pt-br/post/aprendendo-teoria-musical-escrevendo-melodias.html<p>Olha só, primeiro artigo não-técnico no blog 🙂.</p> <p>Enfim, eu não cheguei a falar sobre isso por aqui antes, mas eu gosto bastante de tocar piano. Quando eu era mais novo, eu fiz aulas de violão, mas eu sempre quis tocar piano, e alguns anos atrás eu finalmente comprei um! Eu …</p><p>Olha só, primeiro artigo não-técnico no blog 🙂.</p> <p>Enfim, eu não cheguei a falar sobre isso por aqui antes, mas eu gosto bastante de tocar piano. Quando eu era mais novo, eu fiz aulas de violão, mas eu sempre quis tocar piano, e alguns anos atrás eu finalmente comprei um! Eu tenho tocado ele desde então, apesar nunca ter realmente feito aulas e nem praticado intensamente, mas eu me divirto bastante com ele.</p> <p>O que eu mais gosto de fazer é improvisar. Eu acho bem relaxante, e às vezes surgem coisas interessantes que eu quero desenvolver melhor e transformar em uma música.</p> <p>Outra coisa que eu tenho bastante interesse é teoria musical. Eu acho fascinante como é possível dissecar as músicas e chegar nos blocos básicos que as formam e descobrir o que as fazem soar bem. Além disso, eu acho que se eu aprender mais teoria musical eu vou me divertir mais improvisando e compondo 😀.</p> <p>Duas ótimas referências que eu estou usando atualmente para aprender teoria musical são:</p> <ul class="simple"> <li><a class="reference external" href="https://www.daveconservatoire.org/">Dave Conservatoire</a></li> <li><a class="reference external" href="https://www.coursera.org/learn/melodic-forms-simple-harmony">Curso &quot;Approaching Music Theory: Melodic Forms and Simple Harmony&quot; no Coursera</a></li> </ul> <p>O Dave Conservatoire é basicamente um Khan Academy para teoria musical e é muito bom! Eu estou revendo os conceitos básicos e aprendendo algumas coisas novas nele.</p> <p>O curso do Coursera é o que eu estou mais animado, porque ele ensina os blocos básicos da música de um jeito que é divertido, e analisando músicas existentes. Além do mais, há tarefas em que você precisa compor sua própria pequena melodia em estilos diferentes. E é sobre isso que eu quero falar nesse artigo!</p> <p>Até o momento no curso, eu tive que escrever melodias em três estilos diferentes: canto gregoriano, jazz e música tradicional. Eu tentei compor apenas escrevendo no papel, mas sinceramente acabei dependendo bastante de tocar as notas no piano para ouvir como cada uma soava.</p> <p>Depois que eu acabei cada melodia, eu a transcrevi para uma partitura mais bem feita usando o <a class="reference external" href="https://musescore.org">MuseScore</a>, que é um programa de código aberto sensacional para escrever partituras. O que é ainda mais incrível é que ele é capaz de tocar suas partituras usando MIDI! Então para cada melodia eu exportei tanto a partitura quando o áudio para mostrar aqui.</p> <div class="section" id="minhas-melodias"> <h2>Minhas melodias</h2> <div class="section" id="canto-gregoriano"> <h3>Canto gregoriano</h3> <p>A ideia no canto gregoriano era fazer algo usando um conjunto bem limitado de notas e poucos saltos, mas como você pode ver eu quebrei essa segunda regra, apesar que eu acho que soou bem.</p> <p>Por ser um <a class="reference external" href="https://pt.wikipedia.org/wiki/Canto_gregoriano">canto gregoriano</a>, a partitura deveria ter apenas 4 linhas e não ter compassos, deveria ter um andamento fluido. Mas o MuseScore não foi feito para isso, então é por isso que tanto o áudio quanto a partitura são mais &quot;robóticos&quot; do que eu gostaria.</p> <p><a class="reference external" href="https://nfraprado.net/pt-br/audio/melodies/gregorian_chant.mp3">Ouça aqui</a></p> <img alt="Partitura da melodia de canto gregoriano" src="/images/melodies/gregorian_chant.png" /> </div> <div class="section" id="jazz-lento"> <h3>Jazz lento</h3> <p>Já para o jazz lento deveria haver uma noção de tempo mais estrita, mas ter os tons mais livres, sendo inclusive encorajada a presença de notas alteradas.</p> <p>Para as alterações eu usei um Lá e um Ré naturais, mas como você pode ver, não há nenhum Lá sustenido para fazer com que os naturais soem fora da armadura de clave, o que eu só aprendi depois. Isso é definitivamente algo que eu gostaria de melhorar da próxima vez.</p> <p>Eu também acho que eu sem querer coloquei muito uma estética da trilha sonora do Genshin Impact, que apesar de ser bonita, não é jazz 😛.</p> <p><a class="reference external" href="https://nfraprado.net/pt-br/audio/melodies/slow_jazz.mp3">Ouça aqui</a></p> <img alt="Partitura da melodia de jazz lento" src="/images/melodies/slow_jazz.png" /> </div> <div class="section" id="musica-tradicional"> <h3>Música tradicional</h3> <p>Por fim, a melodia de música tradicional deveria ser algo mais repetitivo e fácil de lembrar e cantar junto. Eu fiz em pentatônica porque aprendi que funcionava bem, e eu também acho que ter um ritmo interessante é importante, então foi o que eu fiz.</p> <p><a class="reference external" href="https://nfraprado.net/pt-br/audio/melodies/folk.mp3">Ouça aqui</a></p> <img alt="Partitura da melodia de música tradicional" src="/images/melodies/folk.png" /> <p>Isso é tudo por enquanto, mas espero compartilhar mais em breve 🙂.</p> </div> </div> Mudando para o Wayland2021-03-21T00:00:00-03:002021-03-21T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-03-21:/pt-br/post/mudando-para-o-wayland.html<p>No meio de janeiro, meu computador decidiu me surpreender, e não de um jeito bom. Diferentemente de todas as peculiaridades que eu já estava acostumado nele depois desses 6 anos de uso — teclando falhando, tela piscando, saída de áudio com mal contato — dessa vez era pior, e nem era um …</p><p>No meio de janeiro, meu computador decidiu me surpreender, e não de um jeito bom. Diferentemente de todas as peculiaridades que eu já estava acostumado nele depois desses 6 anos de uso — teclando falhando, tela piscando, saída de áudio com mal contato — dessa vez era pior, e nem era um problema de hardware.</p> <p>No mínimo uma vez por dia, o computador travava completamente. A única ação que surtia algum efeito era segurar o botão de desligar para forçá-lo a desligar. Não exatamente o ideal...</p> <p>Eu tive a idea de tentar entrar nele via SSH usando meu celular (ainda bem que o Termux existe) e isso funcionou. Eu listei os processos e vi <code class="docutils literal">xorg-server</code> usando 100% da CPU. Eu matei ele, e o computador magicamente voltou à vida. Mas obviamente, já que eu acabei de matar a interface gráfica, todas minhas aplicações abertas foram pro saco, e basicamente dava na mesma do que eu ter reiniciado o computador.</p> <p>Depois de três dias aguentando isso, tentando checar logs para depurar o programa, eu desisti do X.Org.</p> <p>Certamente a maioria de vocês sabem sobre isso, e eu com certeza não sou qualificado para explicar, mas o X.Org, a aplicação que que serviu de base para as interfaces gráficas no Linux por muito tempo é uma grande bagunça. O seu código é muito difícil de manter, e a sua arquitetura apresenta problemas de segurança, tanto que uma nova alternativa surgiu vários anos atrás chamada <a class="reference external" href="https://wayland.freedesktop.org/">Wayland</a>.</p> <p>A questão é que muitas aplicações hoje ainda dependem do X, o que também significa que mudar para o Wayland pode ser uma mudança não muito suave. Então apesar da mudança para o Wayland do ecossistema como um todo parecer inevitável, as pessoas ainda estão confortáveis o suficiente no X.Org por enquanto.</p> <p>E eu também era uma dessas pessoas, até que o próprio X me deu um motivo para mudar. Esse problema provavelmente poderia ser investigado e consertado, mas por que gastar tempo com <a class="reference external" href="https://www.phoronix.com/scan.php?page=news_item&amp;px=X.Org-Maintenance-Mode-Quickly">algo que vai entrar em modo de manutenção em breve</a>? Enfim chegou a hora de eu dar uma chance ao Wayland.</p> <div class="section" id="fazendo-a-mudanca"> <h2>Fazendo a mudança</h2> <p>Do meu ponto de vista, mudar para o Wayland significava basicamente instalar ele e mudar todas as aplicações que eu usava que dependiam do X, por equivalentes que funcionassem no Wayland. A principal sendo a interface gráfica em si, que no meu caso era o gerenciador de janelas <a class="reference external" href="https://i3wm.org/">i3</a>.</p> <p>Felizmente, já existe um gerenciador de janelas bem estabelecido que é compatível com o i3 para o Wayland, que é o <a class="reference external" href="https://swaywm.org/">sway</a>, então essa mudança foi bem tranquila. Foi só questão de instalar o sway e mudar um pouco o arquivo de configuração.</p> <p>O que ajudou bastante foi que a wiki do sway tem um <a class="reference external" href="https://github.com/swaywm/sway/wiki/i3-Migration-Guide">guia de migração do i3</a>, que não só mostra as principais mudanças necessárias na configuração do i3 para que ela funcione no sway, mas também uma lista dos programas Wayland equivalentes aos normalmente usados no X.Org.</p> <p>Por exemplo, a definição e troca do layout de teclado, que normalmente é feita pelo setxkbmap no X, é integrada ao sway então eu apenas usei comandos <code class="docutils literal">input</code> no config do sway para configurar os layouts possíveis e ter um atalho para alternar entre eles.</p> <p>Ainda a respeito do teclado, eu me acostumei bastante a usar meu Caps Lock para duas funções distintas: ele funciona como Esc quando é pressionado sozinho, mas como Control quando é segurado enquanto outra tecla é apertada. Eu usava setxkbmap junto com xcape para fazer isso, mas claramente eles não eram opções no Wayland.</p> <p>Quem me salvou foi o <a class="reference external" href="https://gitlab.com/interception/linux/tools">Interception Tools</a>, que permite que o mesmo seja feito independente de estar no X ou no Wayland. Ele por si só apenas provê a estrutura, mas essa função de Control e Esc no Caps Lock que mencionei pode ser facilmente configurada usando o plugin oficial <a class="reference external" href="https://gitlab.com/interception/linux/plugins/caps2esc">caps2esc</a>.</p> <p>Ah, e ele também pode ser combinado com outro plugin, <a class="reference external" href="https://gitlab.com/interception/linux/plugins/space2meta">space2meta</a>, para usar a barra de espaço como espaço quando apertada, mas como a tecla Meta (o modificador no i3/sway) quando segurada. Eu já tinha experimentado isso no X usando o xcape mas eu acabava disparando atalhos do i3 sem querer, então eu parei de usar. Mas já que o space2meta é mais esperto e apenas manda a tecla no evento da tecla solta, é bem usável e vale a pena pelo maior conforto.</p> <p>Uma pequena tangente: Se o caps2esc e o space2meta parecem loucura para você, eu realmente aconselho experimentar. Principalmente o caps2esc, já que ele não tem nenhuma desvantagem, sinceramente. Pense bem, você realmente usa tanto o Caps Lock? Não faz sentido mantê-lo na fileira central do teclado. Já o Esc e o Control são muito úteis, ainda mais se você usa Vim. Bom, voltando...</p> <p>E o <a class="reference external" href="https://github.com/davatorium/rofi">rofi</a>, um menu de seleção, que eu uso para várias coisas diferentes? Também depende do X. Existe uma alternativa para o Wayland chamado <a class="reference external" href="https://hg.sr.ht/~scoopta/wofi">wofi</a>, mas eu não gostei dele. Senti que ele é um pouco lento e não sou fã de ele ser GTK (o ícone de lupa do lado do campo de entrada me incomoda bastante). Eu só quero um retângulo de um única cor com um título, caixa de entrada e as opções filtradas destacadas abaixo, e o rofi faz isso muito melhor. Por sorte, uma alma corajosa criou um <a class="reference external" href="https://github.com/lbonn/rofi">fork do rofi para o Wayland</a> e ele funciona sem nenhum problema. Praticamente...</p> <p>Infelizmente a funcionalidade de troca de janela não funciona nele. E eu acho ela muito útil para pular diretamente para uma aplicação aberta, caso contrário eu preciso passar por todos os workspaces procurando por ela. Mas foi bastante fácil encontrar um script de troca de janela na internet, mas para o wofi, então eu apenas mudei ele um pouco para funcionar com o rofi e assim consegui <a class="reference external" href="https://gist.github.com/nfraprado/484a0dfe60c49b7d2e9dfb45c3c4a4b5">meu script de troca de janela</a>. E agora sim, um rofi perfeito no Wayland.</p> <p>Capturar a tela com o maim também não era mais possível. A alternativa é o <a class="reference external" href="https://github.com/emersion/grim">grim</a>, e um programa separado, <a class="reference external" href="https://github.com/emersion/slurp">slurp</a>, para permitir que uma região ou janela seja selecionada para a captura. Como um bônus interessante, como o README do grim mostra, é bem simples usá-lo, junto com o slurp e imagemagick, para obter a cor do pixel embaixo do mouse, então eu também configurei esse modo. Minha tentativa anterior de fazer isso com o maim falhou, então esse foi um bom bônus de ter mudado para o Wayland.</p> <p>xclip obviamente também não funciona no Wayland. Então para continuar tendo um clipboard funcional, eu precisei instalar <a class="reference external" href="https://github.com/bugaevc/wl-clipboard">wl-clipboard</a>. Mas isso não foi o suficiente para o Vim. Nele, operações no clipboard são feitas através do registrador <code class="docutils literal">+</code>, por exemplo <code class="docutils literal">&quot;+yy</code> para copiar a linha atual para o clipboard, mas isso não funciona com o clipboard do Wayland. Eu cheguei muito perto de instalar o Neovim já que aparentemente isso funciona por padrão nele, mas eu encontrei o plugin de Vim <a class="reference external" href="https://github.com/jasonccox/vim-wayland-clipboard">vim-wayland-clipboard</a> que funciona perfeitamente.</p> <p>Uma coisa que eu não esperava que não funcionasse de cara era o compartilhamento de tela. Felizmente <a class="reference external" href="https://wiki.archlinux.org/index.php/PipeWire#WebRTC_screen_sharing">a página do PipeWire na Archwiki</a> fornece instruções de como fazer funcionar, e é bem simples: apenas configurar uma variável de ambiente e instalar <a class="reference external" href="https://github.com/emersion/xdg-desktop-portal-wlr">xdg-desktop-portal-wlr</a> e <code class="docutils literal">pipewire-media-session</code>. Dito isso, eu tive um <a class="reference external" href="https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/768">problema</a> depois de uma atualização no PipeWire, mas ao que tudo indica já foi resolvido.</p> <p>Eu também mudei meu daemon de notificação do dunst para o <a class="reference external" href="https://github.com/emersion/mako">mako</a>. Mas pelo que vi, a partir da versão 1.6.0, o dunst também suporta Wayland, apesar de ainda não ter sido empacotado no Arch Linux. Mas eu sinceramente também estou satisfeito com o mako, então acho que vou continuar com ele.</p> <p>Algumas outras mudanças que eu acho que não precisam de nenhum comentário adicional:</p> <ul class="simple"> <li><a class="reference external" href="https://github.com/haikarainen/light">light</a> ao invés de xbacklight para controlar o brilho da tela</li> <li><a class="reference external" href="https://gitlab.com/chinstrap/gammastep">gammastep</a> ao invés de redshift para tornar a temperatura da tela mais agradável de noite</li> <li><a class="reference external" href="https://github.com/eXeC64/imv">imv</a> ao invés de sxiv como o visualizador de imagens</li> </ul> <p>E finalmente, é importante mencionar o Xwayland. Ele é a aplicação que te permite rodar aplicações X no Wayland. Não funciona para tudo (caso contrário eu não teria mudado todas as aplicações anteriores), mas por exemplo para aplicações Electron e para a Steam e jogos funcionou perfeitamente até agora, tanto que é difícil saber que eles não são nativos no Wayland, o que é incrível. Se o Wayland quer ser o futuro, ele precisa permitir que as aplicações X atuais continuem rodando nele enquanto elas não são devidamente portadas para o Wayland.</p> </div> <div class="section" id="plot-twist"> <h2>Plot twist</h2> <p>Depois de todas essas mudanças eu estava totalmente estabelecido no Wayland, mas ainda sim aconteciam alguns glitches gráficos. De tempo em tempo, as aplicações começavam a piscar de jeitos estranhos e nada que eu fizesse fazia com que parassem, a não ser, claro, fechar o Wayland. Então eu estava essencialmente de volta ao ponto de partida, mas um pouco melhor já que nesse caso o computador não travava completamente, então eu pelo menos tinha chance de salvar tudo antes de reiniciar.</p> <p>Felizmente, no meio-tempo eu recebi um computador novo da empresa em que estou trabalhando, o que foi ótimo dadas as peculiaridades do meu computador antigo. E já que eu já tinha me dado o trabalho de fazer a transição para o Wayland, eu instalei sway nesse novo computador também. E tudo funcionou perfeitamente. Sem problema algum.</p> <p>Então, qual é a conclusão dessa história? O problema do congelamento/glitch gráfico era algo relacionado ao hardware do meu computador antigo e não no X em si, mas pelo menos isso me deu o empurrão que eu precisava para finalmente migrar para o Wayland. Sim, eu provavelmente poderia ter continuado no X no computador novo, mas isso seria apenas postergar o inevitável. O importante é que agora tudo funciona, e eu me sinto muito mais confortável em depurar e reportar problemas com a nova interface gráfica, dado que ela é bem mantida, caso eles aconteçam no futuro.</p> </div> Ledsticker: Meu primeiro projeto holístico de SW + HW2021-02-20T00:00:00-03:002021-02-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-02-20:/pt-br/post/ledsticker-meu-primeiro-projeto-holistico-de-sw-hw.html<p>Era julho de 2019. Eu estava fazendo aula de Laboratório de Sistemas Embarcados e tinha que fazer um projeto final de minha escolha. Eu tive a ideia de fazer uma espécie de Guitar Hero usando um teclado como entrada, uma matriz de LED 8x8 para mostrar as notas e alto-falantes …</p><p>Era julho de 2019. Eu estava fazendo aula de Laboratório de Sistemas Embarcados e tinha que fazer um projeto final de minha escolha. Eu tive a ideia de fazer uma espécie de Guitar Hero usando um teclado como entrada, uma matriz de LED 8x8 para mostrar as notas e alto-falantes para tocar o som das notas. O problema era que a faculdade não disponibilizava matriz de LED nem alto-falantes, então eu decidi comprá-los, com a desculpa de que eu usaria eles depois para os meus projetos pessoais também.</p> <p>Esse projeto deu certo, e o resultado pode ser visto no <a class="reference external" href="https://www.youtube.com/watch?v=JIfGUSdEFQ0">YouTube</a>. Mas tendo finalizado ele, eu comecei a pensar o que eu iria fazer com a matriz de LED. Eventualmente, eu tive uma ideia que era tão legal que não tinha como não fazer.</p> <p>Eu gostava de grudar adesivos que achasse legais na tampa do meu notebook, e eu tinha muitos deles, mas se você parar para pensar, adesivos não são tão interessantes. Então e se eu usasse a matriz de LED como um adesivo? Eu poderia grudá-la na tampa do notebook e conectá-la à porta USB tanto para fornecer energia quanto permitir que ela pudesse ser controlada. Eu seria capaz de programar qualquer coisa que eu quisesse que fosse mostrada na matriz.</p> <div class="section" id="prototipagem"> <h2>Prototipagem</h2> <p>O primeiro passo para tornar isso realidade era construir um protótipo. Eu já tinha o módulo da matriz de LED, mas ele recebia os dados através de um barramento SPI ao invés do USB que eu queria usar. Eu comecei a procurar na internet por um circuito que convertesse USB para SPI e encontrei o CI MCP2210. Eu comprei alguns deles, mas também comprei sua versão em placa de desenvolvimento, com o CI na placa pronto para uso, para que o processo de prototipagem inicial fosse mais fácil.</p> <p>Então eu procurei por um programa que implementasse a interface com o MCP2210 e encontrei <a class="reference external" href="https://github.com/kerrydwong/MCP2210-Library">MCP2210-Library</a>. Eu comecei a escrever o meu próprio programa para inicializar o CI responsável por controlar a matriz de LED, o MAX7219, (presente no módulo de matriz de LED) através da chamada das funções dessa biblioteca para enviar os dados SPI através do USB (os quais o MCP2210 depois encaminhava através do barramento SPI para o MAX7219).</p> <p>Nesse ponto eu tinha o mínimo necessário para verificar a viabilidade do projeto: os componentes de hardware necessários nos próprios módulos prontos para uso e um software mínimo capaz de interagir com os CIs e desenhar um padrão fixo na matriz de LED. Eu conectei o módulo USB-para-SPI no computador e módulo da matriz de LED e rodei o meu programa:</p> <img alt="Módulos de USB-para-SPI e da matriz de LED conectados. Alguns LEDs estão ligados mostrando que está funcionando." src="/images/ledsticker/modules.png" /> <p>Tendo confirmado que o projeto de fato era viável, eu comecei a avançar nos passos necessários para torná-lo usável ao usuário final. A primeira coisa era tornar simples o controle da matriz de LED para os propósitos do projeto. Foi nesse ponto que eu defini o conceito de <em>adesivo</em>, que é central ao projeto.</p> <div class="section" id="adesivos"> <h3>Adesivos</h3> <p>Eu queria que fosse possível mostrar três coisas diferentes na matriz de LED:</p> <ul class="simple"> <li>Uma &quot;imagem&quot; estática, ou seja, ligar um padrão estático de LEDs.</li> <li>Uma &quot;imagem&quot; animada, ou seja, mostrar uma sequência de padrões, cada um depois de um certo atraso</li> <li>Uma &quot;imagem&quot; animada mas que fosse gerada dinamicamente da saída de um programa, para que eu pudesse mostrar uma simulação do <a class="reference external" href="https://pt.wikipedia.org/wiki/Jogo_da_vida">Jogo da Vida</a>, por exemplo.</li> </ul> <p>Para permitir os dois primeiros casos de uso, eu defini o conceito de um adesivo estático. Ele consiste em um arquivo de texto contendo uma sequência de comandos que determinam o que é mostrado na matriz. Existem comandos para ligar e desligar pixels individuais, colunas ou linhas inteiras, ou a tela inteira, também para atualizar a tela, etc.</p> <p>Para possibilitar o terceiro caso de uso, eu defini o adesivo dinâmico, que é qualquer programa, programado em qualquer linguagem, que escreve esses comandos de adesivo em sua saída. Dessa forma, uma linguagem de programação pode ser usada para gerar um adesivo mais complexo e dinâmico.</p> <p>A ideia portanto é que o usuário executaria o programa <code class="docutils literal">ledsticker</code> e passaria como parâmetro um adesivo estático ou dinâmico. Se fosse estático, os comandos seriam lidos e a matriz de LED atualizada de acordo. Se fosse dinâmico, ele seria executado e sua saída usada como um adesivo estático da mesma forma.</p> <p>Para que tudo isso funcionasse, eu precisava tanto definir os comandos dos adesivos, como também implementar a leitura desses comandos pelo meu programa. Como um exemplo dos comandos, o mais simples é <code class="docutils literal">on R C</code>, que liga o LED da linha <code class="docutils literal">R</code> e coluna <code class="docutils literal">C</code>.</p> <p>Finalmente, para confirmar que esses comandos eram o suficiente, e também por diversão, eu implementei alguns adesivos: um único quadro com a cara do Creeper, um Tetris animado, e uma simulação gerada dinamicamente do Jogo da Vida.</p> </div> <div class="section" id="hardware"> <h3>Hardware</h3> <p>Nesse ponto eu já tinha o software totalmente operacional, então eu queria começar a avançar no lado do hardware. Eu estava usando módulos separados para a matriz de LED e para o USB-para-SPI, mas o objetivo mesmo era ter isso tudo em uma única e pequena placa de circuito impresso (PCB), para que fosse conveniente anexá-la à tampa do notebook.</p> <p>Mas antes de começar a fazer a PCB, eu precisava ter certeza sobre o circuito. Eu tinha dois módulos separados que eu sabia que funcionavam, então eu usei eles como referência e li os datasheets do MAX7219 e do MCP2210 para criar o esquemático do circuito no <a class="reference external" href="https://kicad.org">KiCad</a>.</p> <p>Ao final, meu esquemático ficou com os dois CIs principais, MAX7219 e MCP2210, além de outros componentes passivos necessários para o funcionamento deles (resistores, capacitores e um cristal), bem como a matriz de LED e um conector USB mini.</p> <p>O símbolo de esquemático (e footprint) da matriz de LED (modelo 1088AS) em especial eu precisei criar por contra própria, já que ele não existia. Eu segui a <a class="reference external" href="https://www.youtube.com/watch?v=vaCVh2SAZY4&amp;list=PLEBQazB0HUyR24ckSZ5u05TZHV9khgA1O">série de introdução ao KiCad da DigiKey</a> para isso.</p> <p>Com o circuito decidido, eu soldei todos os componentes e conexões em uma placa universal (teria sido mais fácil usar uma protoboard, mas eu não tinha uma boa) para testar. A parte mais difícil foi que o MCP2210 é um dispositivo de montagem superficial (SMD), e SMDs não são feitos para serem soldados em uma placa universal. O que eu fiz foi comprar uma PCB adaptadora de SMD com o tamanho correto de pinos para que eu conseguisse soldar o CI nela e soldá-la na minha placa. Tudo isso ficou assim:</p> <img alt="Placa protótipo para o Ledsticker. Todos os componentes e conexões estão soldados." src="/images/ledsticker/prototype.jpg" /> <p>Depois de testar essa placa com alguns adesivos e concluir que estava funcionando bem, a última coisa que restava era fazer a PCB.</p> </div> </div> <div class="section" id="pcb"> <h2>PCB</h2> <p>Eu nunca tinha feito uma PCB, e a ideia de finalmente aprender a fazer uma foi uma das coisas que me motivou a fazer esse projeto para começo de conversa.</p> <p>Eu aprendi praticamente tudo seguindo a <a class="reference external" href="https://www.youtube.com/watch?v=vaCVh2SAZY4&amp;list=PLEBQazB0HUyR24ckSZ5u05TZHV9khgA1O">série de introdução ao KiCad da DigiKey</a> que eu já mencionei. Há muitos passos diferentes em fazer uma PCB, mas eles não chegam a ser difíceis, só trabalhosos às vezes. Posicionar os componentes de uma forma compacta tendo em mente as ligações que precisariam ser feitas foi bastante complicado, mas foi um desafio divertido.</p> <p>Depois que finalizei o projeto no KiCad, eu encomendei a PCB da OSHPark. Depois de 3 longos meses esperando (por conta de demoras no transporte de navio devido à pandemia), a placa finalmente chegou.</p> <p>Depois de tanto tempo esperando pela placa, eu não perdi tempo para soldar. Peguei todos os componentes e soldei tudo no mesmo dia. Aqui estão todos os componentes junto com a PCB:</p> <img alt="PCB customizada para o Ledsticker no topo. Todos os componentes que serão soldados em baixo." src="/images/ledsticker/components_pcb.jpg" /> <p>Metade do caminho (era o que eu pensava):</p> <img alt="PCB com apenas alguns dos componentes soldados." src="/images/ledsticker/partially_soldered_pcb.jpg" /> <p>Soldar os componentes SMD (MCP2210 e o conector USB mini) foi muito mais difícil do que o restante. O conector USB mini em particular foi praticamente impossível. Os contatos na PCB para os seus 5 pinos eram praticamente do mesmo tamanho que os pinos do conector em si, e não eram muito acessíveis para o ferro de solda. Mas depois de múltiplas tentativas, eu finalmente consegui. Aqui está a placa final:</p> <img alt="PCB com todos os componentes soldados." src="/images/ledsticker/final_board.jpg" /> <p>Nem preciso dizer que foi incrível ver minha própria PCB. Tem algo mágico em segurar algo que você mesmo projetou, que escrever software nunca poderia proporcionar. Ver o circuito todo muito bem organizado na PCB também deu uma impressão muito mais robusta e profissional (veja de novo a placa de prototipagem como comparação...).</p> </div> <div class="section" id="resultados"> <h2>Resultados</h2> <p>Com tudo finalmente pronto, a placa e o programa, era hora de brincar. O gif seguinte mostra tanto a linha de comando usada para carregar o adesivo quanto a placa sendo atualizada. Três adesivos são carregados em sequência. Primeiro uma cara de Creeper estática, depois uma animação de Tetris, e finalmente uma simulação do Jogo da Vida gerada por um programa em python &quot;em tempo real&quot; <a class="footnote-reference" href="#footnote-1" id="footnote-reference-1">[1]</a>:</p> <img alt="GIF mostrando a linha de comando e a placa com os LEDs atualizando simultaneamente. Três adesivos são mostrados em sequência." src="/images/ledsticker/ledsticker.gif" /> <p>E isso marca o projeto como concluído! Calma, mas e a parte de grudar a placa na tampa do notebook? Bom, quando eu comecei esse projeto, eu tinha essa intenção por um motivo social: conforme eu andasse com o meu notebook pela universidade, pessoas iriam me perguntar sobre ele, então eu teria uma desculpa para ter conversas nerds sobre a placa e seria um ótimo começador de conversas. Mas com a pandemia, eu sempre estou em casa, então fazer isso não só seria inútil como aí nem mesmo <em>eu</em> veria a placa. E é por isso que eu estou adiando a anexação para depois que eu voltar a frequentar espaços públicos de novo. Mas só para dar uma ideia de como ficaria, eu grudei ela com fita adesiva só para essa foto:</p> <img alt="Tampa do notebook com adesivos comuns cobrindo a maior parte e o Ledsticker no meio mostrando o adesivo de cara de Creeper." src="/images/ledsticker/notebook.jpg" /> </div> <div class="section" id="conclusao"> <h2>Conclusão</h2> <p>Esse foi de longe meu projeto preferido. Realmente foi um projeto holístico, onde eu projetei tanto o software quanto o hardware e precisei pensar em muitos aspectos diferentes. No lado do software eu precisei criar comandos para prover uma boa interface com o usuário além de implementar o programa como um todo (a não ser pela comunicação com o MCP2210). No lado do hardware eu investiguei datasheets para projetar o circuito, organizei tudo para ser compacto e fiz minha primeira PCB!</p> <p>Se você achou o projeto interessante, eu te convido a fazer sua própria placa ledsticker e criar seus próprios adesivos! Tudo é aberto. Você pode encontrar o programa de linha de comando junto com informações detalhadas sobre ele em <a class="reference external" href="https://codeberg.org/nfraprado/ledsticker">ledsticker</a>. O esquemático da placa junto com a descrição do hardware podem ser encontrados em <a class="reference external" href="https://codeberg.org/nfraprado/ledsticker-hw">ledsticker-hw</a>. Você também pode <a class="reference external" href="https://oshpark.com/shared_projects/MHbtuh9G">encomendar a PCB diretamente da OSHPark</a> caso queira (eu não vou receber nada por isso). Ah, e se você fizer a placa ou um adesivo, eu adoraria saber! 😃 (Você pode encontrar meu email na página Sobre).</p> <img alt="Ledsticker with a Glider sticker. The Glider is walking diagonally on loop." src="/images/ledsticker/glider.gif" /> <table class="docutils footnote" frame="void" id="footnote-1" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> <tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>Não é realmente em tempo real. O programa do adesivo dinâmico é executado o mais rápido possível, preenchendo o buffer de entrada do <code class="docutils literal">ledsticker</code>, que é então consumido quadro a quadro muito mais lentamente, dependendo do FPS que foi configurado.</td></tr> </tbody> </table> </div> Organização além do Taskwarrior2021-01-20T00:00:00-03:002021-01-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2021-01-20:/pt-br/post/organizacao-alem-do-taskwarrior.html<p>No artigo anterior dessa série, eu falei sobre todas as minhas customizações no Taskwarrior e no VIT, e meu fluxo de trabalho com eles, que me permite organizar e concluir minhas tarefas. No entanto, apenas tarefas não são o suficiente para se organizar.</p> <p>Outro componente crucial na organização é ter …</p><p>No artigo anterior dessa série, eu falei sobre todas as minhas customizações no Taskwarrior e no VIT, e meu fluxo de trabalho com eles, que me permite organizar e concluir minhas tarefas. No entanto, apenas tarefas não são o suficiente para se organizar.</p> <p>Outro componente crucial na organização é ter um calendário. Ele te permite estar ciente de tarefas e eventos que são sensíveis ao tempo (por exemplo, com data de entrega), e também tomar decisões bem informadas no momento de marcar novos eventos. Claro que nada disso é novo, e é até parte do <a class="reference external" href="https://pt.wikipedia.org/wiki/Getting_Things_Done">GTD</a>.</p> <p>Mas algo que não é parte do GTD, e que eu senti falta, é algo para estabelecer uma rotina. O GTD é um ótimo sistema para acompanhar as diferentes tarefas de cada projeto na sua vida, e para concluí-los, mas ele não tem a menor preocupação em reservar diferentes porções do seu dia ou semana para fazer os básicos (como comer), fazer algo regularmente (como praticar piano), ou avançar nas tarefas gerais. Ele apenas organiza o que fazer e <a class="reference external" href="https://nfraprado.net/pt-br/post/deteccao-de-contexto-automatica-para-o-taskwarrior.html">em quais contextos</a>, mas não exatamente quando, o que pode deixar a desejar, quando se está tentando <a class="reference external" href="https://waitbutwhy.com/2016/10/100-blocks-day.html">aproveitar bem o tempo</a>.</p> <p>Portanto, além de ter o VIT como meu organizador central de tarefas, meu sistema também precisa</p> <ul class="simple"> <li>de um calendário decente, de alguma forma integrado ao VIT para também mostrar os prazos de tarefas, além dos compromissos normais</li> <li>um jeito de configurar uma rotina, e de ser constantemente lembrado dela</li> </ul> <p>Vamos ver sobre cada um deles.</p> <div class="section" id="calendario-usando-calcurse"> <h2>Calendário usando calcurse</h2> <p>Antes de mais nada, o próprio Taskwarrior na verdade tem um calendário, que pode ser visto com <code class="docutils literal">task calendar</code>, mas sinceramente ele é inútil. Só é possível ver quais dias tem tarefas, mas não quais são essas tarefas.</p> <p>Eu queria um calendário que me desse uma boa visão geral dos compromissos mensais e semanais, que fosse leve (de preferência de terminal), e customizável o suficiente para ser integrado ao VIT. Eu acabei usando o <a class="reference external" href="https://www.calcurse.org/">calcurse</a>.</p> <p>Agora, a grande questão era: Como eu posso ter minhas tarefas aparecendo no calcurse? Bom, já que o calcurse usa um arquivo de texto com uma sintaxe simples para armazenar todos os compromissos, eu só precisava de um script que lesse todas as tarefas do Taskwarrior e escrevesse na saída os compromissos usando a sintaxe do calcurse. E esse foi o script que eu escrevi:</p> <pre class="code python literal-block"> <span class="ch">#!/bin/python</span><span class="w"> </span><span class="kn">from</span><span class="w"> </span><span class="nn">tasklib</span><span class="w"> </span><span class="kn">import</span> <span class="n">TaskWarrior</span><span class="w"> </span><span class="kn">import</span><span class="w"> </span><span class="nn">sys</span><span class="w"> </span><span class="n">tw</span> <span class="o">=</span> <span class="n">TaskWarrior</span><span class="p">(</span><span class="s1">'/home/nfraprado/.task/data'</span><span class="p">)</span><span class="w"> </span><span class="c1"># Parse appointments</span><span class="w"> </span><span class="n">apts</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'(status:pending or status:waiting or status:completed)'</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="s1">'cal'</span><span class="p">)</span><span class="w"> </span><span class="k">for</span> <span class="n">apt</span> <span class="ow">in</span> <span class="n">apts</span><span class="p">:</span><span class="w"> </span> <span class="n">start</span> <span class="o">=</span> <span class="n">apt</span><span class="p">[</span><span class="s1">'scheduled'</span><span class="p">]</span><span class="w"> </span> <span class="k">if</span> <span class="n">start</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span><span class="w"> </span> <span class="n">sys</span><span class="o">.</span><span class="n">stderr</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Apt '</span><span class="si">{</span><span class="n">apt</span><span class="si">}</span><span class="s2">' has no sched date!</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">continue</span><span class="w"> </span> <span class="n">summary</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">apt</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="n">start</span><span class="o">.</span><span class="n">hour</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">start</span><span class="o">.</span><span class="n">minute</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="n">start_fmt</span> <span class="o">=</span> <span class="n">start</span><span class="o">.</span><span class="n">strftime</span><span class="p">(</span><span class="s2">&quot;%m/</span><span class="si">%d</span><span class="s2">/%Y&quot;</span><span class="p">)</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">start_fmt</span><span class="si">}</span><span class="s2"> [1] </span><span class="si">{</span><span class="n">summary</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">start_fmt</span> <span class="o">=</span> <span class="n">start</span><span class="o">.</span><span class="n">strftime</span><span class="p">(</span><span class="s2">&quot;%m/</span><span class="si">%d</span><span class="s2">/%Y &#64; %H:%M&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="n">apt</span><span class="p">[</span><span class="s1">'due'</span><span class="p">]:</span><span class="w"> </span> <span class="n">end_fmt</span> <span class="o">=</span> <span class="n">apt</span><span class="p">[</span><span class="s1">'due'</span><span class="p">]</span><span class="o">.</span><span class="n">strftime</span><span class="p">(</span><span class="s2">&quot;%m/</span><span class="si">%d</span><span class="s2">/%Y &#64; %H:%M&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">end_fmt</span> <span class="o">=</span> <span class="n">start_fmt</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">start_fmt</span><span class="si">}</span><span class="s2"> -&gt; </span><span class="si">{</span><span class="n">end_fmt</span><span class="si">}</span><span class="s2">|</span><span class="si">{</span><span class="n">summary</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span><span class="c1"># Parse due dates for next actions and projects</span><span class="w"> </span><span class="n">tasks</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'(status:pending or status:waiting) and (type:next or '</span><span class="w"> </span> <span class="s1">'type:objective or type:standby)'</span><span class="p">)</span><span class="w"> </span><span class="k">for</span> <span class="n">task</span> <span class="ow">in</span> <span class="n">tasks</span><span class="p">:</span><span class="w"> </span> <span class="k">for</span> <span class="n">date_type</span><span class="p">,</span> <span class="n">label</span> <span class="ow">in</span> <span class="p">[(</span><span class="s1">'due'</span><span class="p">,</span> <span class="s2">&quot;Prazo final: &quot;</span><span class="p">),</span><span class="w"> </span> <span class="p">(</span><span class="s1">'scheduled'</span><span class="p">,</span> <span class="s2">&quot;Prazo inicial: &quot;</span><span class="p">)]:</span><span class="w"> </span> <span class="k">if</span> <span class="ow">not</span> <span class="n">task</span><span class="p">[</span><span class="n">date_type</span><span class="p">]:</span> <span class="c1"># Skip tasks with no date</span><span class="w"> </span> <span class="k">continue</span><span class="w"> </span> <span class="n">start</span> <span class="o">=</span> <span class="n">task</span><span class="p">[</span><span class="n">date_type</span><span class="p">]</span><span class="w"> </span> <span class="n">proj</span> <span class="o">=</span> <span class="s2">&quot;Projeto: &quot;</span> <span class="k">if</span> <span class="n">task</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;objective&quot;</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span><span class="w"> </span> <span class="n">summary</span> <span class="o">=</span> <span class="n">label</span> <span class="o">+</span> <span class="n">proj</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">task</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="n">start</span><span class="o">.</span><span class="n">hour</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">start</span><span class="o">.</span><span class="n">minute</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="n">start_fmt</span> <span class="o">=</span> <span class="n">start</span><span class="o">.</span><span class="n">strftime</span><span class="p">(</span><span class="s2">&quot;%m/</span><span class="si">%d</span><span class="s2">/%Y&quot;</span><span class="p">)</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">start_fmt</span><span class="si">}</span><span class="s2"> [1] </span><span class="si">{</span><span class="n">summary</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">start_fmt</span> <span class="o">=</span> <span class="n">start</span><span class="o">.</span><span class="n">strftime</span><span class="p">(</span><span class="s2">&quot;%m/</span><span class="si">%d</span><span class="s2">/%Y &#64; %H:%M&quot;</span><span class="p">)</span><span class="w"> </span> <span class="n">end_fmt</span> <span class="o">=</span> <span class="n">start_fmt</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">start_fmt</span><span class="si">}</span><span class="s2"> -&gt; </span><span class="si">{</span><span class="n">end_fmt</span><span class="si">}</span><span class="s2">|</span><span class="si">{</span><span class="n">summary</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> </pre> <p>Esse script basicamente define quais as tarefas que vão ser mostradas no calendário e em qual formato. Primeiro, tem as tarefas <code class="docutils literal">cal</code>, que, se você lembrar do artigo passado, são meus compromissos, e são a principal coisa a ser mostrada no calendário. Cada uma delas é convertida em uma entrada no calcurse, com a data <code class="docutils literal">scheduled</code> usada como a hora de início do compromisso, e a data <code class="docutils literal">due</code> como a data de término. O texto do compromisso é simplesmente o texto de descrição da tarefa.</p> <p>O outro caso são as tarefas normais, que aparecem não como um evento contínuo no calendário, mas sim uma entrada para a data de início, para me mostrar quando eu posso começar a fazer a tarefa, e outra para a data de término, para me mostrar até quando eu preciso concluí-la. Além disso, essas sim possuem identificadores a mais no texto de descrição do compromisso, para diferenciá-los dos compromissos normais. Para isso, o script adiciona &quot;Prazo inicial: &quot; à descrição da data de início e &quot;Prazo final: &quot; à descrição da data de término. Por fim, se a tarefa é do tipo <code class="docutils literal">objective</code>, ela além disso tem &quot;Projeto: &quot; adicionado à sua descrição no calendário, significando que essa data é relevante para o projeto como um todo e não a uma única próxima ação.</p> <p>Inicialmente, era isso. Eu mapeei uma tecla no VIT para rodar esse programa e então recarregava os compromissos do calcurse com <code class="docutils literal">R</code>. Dessa forma, eu precisava pressionar duas teclas em duas janelas diferentes para ver o calendário atualizado.</p> <p>Depois de um tempo, eu descobri que o calcurse também suporta <em>hooks</em> (assim como o Taskwarrior, como mostrado no artigo anterior) e adicionei um <em>hook</em> <code class="docutils literal">pre-load</code> com o seguinte:</p> <div class="highlight"><pre><span></span>taskwarrior-task2cal<span class="w"> </span>&gt;<span class="w"> </span>/home/nfraprado/.calcurse/apts </pre></div> <p>O que significa que quando eu pressiono <code class="docutils literal">R</code> no calcurse, ele automaticamente roda meu script para exportar as tarefas para o arquivo do calcurse, e portanto eu agora preciso apertar uma única tecla no calcurse para ver meu calendário atualizado! 🙂</p> <p>O gif a seguir mostra tarefas <code class="docutils literal">next</code> e <code class="docutils literal">cal</code> sendo adicionadas no Taskwarrior e automaticamente aparecendo no calcurse:</p> <img alt="Tarefas sendo mostradas no Taskwarrior e aparecendo automaticamente no calcurse" src="/images/org/calcurse_br.gif" /> <p><a class="reference external" href="https://asciinema.org/a/385766">Em asciinema.org</a></p> <p>Outra pequena coisa que eu tenho é a configuração <code class="docutils literal">notification.command</code> do calcurse com o seguinte:</p> <div class="highlight"><pre><span></span>calcurse<span class="w"> </span>--next<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span>-n<span class="w"> </span>-e<span class="w"> </span><span class="s1">&#39;2s/.*\] \(.*\)/\1/p&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>xargs<span class="w"> </span>-I<span class="w"> </span><span class="s1">&#39;{}&#39;</span><span class="w"> </span>notify-send<span class="w"> </span><span class="s1">&#39; Upcomming appointment&#39;</span><span class="w"> </span><span class="s1">&#39;{}&#39;</span> </pre></div> <p>Isso faz com que ele mostre uma notificação no meu sistema algum tempo (configurável, eu uso 10 minutos) antes de cada compromisso, com sua descrição.</p> </div> <div class="section" id="rotina-usando-python"> <h2>Rotina usando python</h2> <p>O primeiro passo para manter uma rotina é, claro, criá-la.</p> <p>Eu queria um jeito simples e fácil de definir e depois editar minha rotina, então eu a implementei usando dicionários em python, onde a rotina de cada dia da semana é dada por um dicionário separado.</p> <p>A ideia é que a chave define a hora de início de uma ação, e o valor correspondente define a ação em si. A ação é considerada a atual a partir dessa hora até a hora da próxima ação. Por exemplo, eu tenho o seguinte dicionário base para as rotinas:</p> <pre class="code python literal-block"> <span class="n">base</span> <span class="o">=</span> <span class="p">{</span><span class="w"> </span> <span class="s1">'08'</span><span class="p">:</span> <span class="s2">&quot;Banho+café&quot;</span><span class="p">,</span><span class="w"> </span> <span class="s1">'12'</span><span class="p">:</span> <span class="s2">&quot;Almoçar&quot;</span><span class="p">,</span><span class="w"> </span> <span class="s1">'15'</span><span class="p">:</span> <span class="s2">&quot;Piano&quot;</span><span class="p">,</span><span class="w"> </span> <span class="s1">'19'</span><span class="p">:</span> <span class="s2">&quot;Jantar&quot;</span><span class="p">,</span><span class="w"> </span> <span class="s1">'24'</span><span class="p">:</span> <span class="s2">&quot;Dormir&quot;</span><span class="p">,</span><span class="w"> </span><span class="p">}</span> </pre> <p>Se ele fosse usado como uma rotina, significaria que a rotina começa com &quot;Banho+café&quot; das 8 da manhã até meio-dia, quando mudaria para &quot;Almoçar&quot;, e assim por diante.</p> <p>Como todo dicionário em python, eu posso estendê-lo para implementar a rotina de um dia:</p> <pre class="code python literal-block"> <span class="n">segunda</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">base</span><span class="p">)</span><span class="w"> </span><span class="n">segunda</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="w"> </span> <span class="s1">'09'</span><span class="p">:</span> <span class="s2">&quot;Tarefas&quot;</span><span class="p">,</span><span class="w"> </span><span class="p">})</span> </pre> <p>Agora, considerando <code class="docutils literal">segunda</code> como a rotina, &quot;Banho+café&quot; só vai até às 9, quando muda para &quot;Tarefas&quot;, que por sua vez vai até meio-dia, quando &quot;Almoçar&quot; começa, igual antes, etc.</p> <p>Um valor também pode ser deletado, como sempre, usando <code class="docutils literal">del segunda['09']</code>, por exemplo.</p> <p>Para definir a minha rotina semanal nesse sistema, eu preciso apenas criar um dicionário para cada dia da semana usando nomes específicos para as variáveis (<code class="docutils literal">segunda</code>, <code class="docutils literal">terça</code>, <code class="docutils literal">quarta</code>, <code class="docutils literal">quinta</code>, <code class="docutils literal">sexta</code>, <code class="docutils literal">sábado</code> e <code class="docutils literal">domingo</code>).</p> <p>Eu gosto desse sistema porque eu posso adicionar ações simplesmente adicionando seu nome e hora de início, e também porque eu posso adicionar ações comuns em um dicionário base que é estendido pelo dicionário de cada dia, reduzindo redundância.</p> <p>Em seguida, eu tenho um módulo python que sabe como ler cada um dos dicionários para retornar as informações de interesse:</p> <pre class="code python literal-block"> <span class="kn">import</span><span class="w"> </span><span class="nn">datetime</span><span class="w"> </span><span class="kn">import</span><span class="w"> </span><span class="nn">cur_sched</span><span class="w"> </span><span class="n">scheds</span> <span class="o">=</span> <span class="p">[</span><span class="n">cur_sched</span><span class="o">.</span><span class="n">segunda</span><span class="p">,</span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">terça</span><span class="p">,</span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">quarta</span><span class="p">,</span><span class="w"> </span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">quinta</span><span class="p">,</span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">sexta</span><span class="p">,</span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">sábado</span><span class="p">,</span><span class="w"> </span> <span class="n">cur_sched</span><span class="o">.</span><span class="n">domingo</span><span class="p">]</span><span class="w"> </span><span class="n">gran</span> <span class="o">=</span> <span class="mi">30</span><span class="w"> </span><span class="n">max_minute</span> <span class="o">=</span> <span class="mi">60</span> <span class="o">-</span> <span class="n">gran</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_cur_wday_time</span><span class="p">():</span><span class="w"> </span> <span class="n">weekday</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">today</span><span class="p">()</span><span class="o">.</span><span class="n">weekday</span><span class="p">()</span><span class="w"> </span> <span class="n">hour</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">today</span><span class="p">()</span><span class="o">.</span><span class="n">hour</span><span class="w"> </span> <span class="n">minute</span> <span class="o">=</span> <span class="p">(</span><span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">today</span><span class="p">()</span><span class="o">.</span><span class="n">minute</span> <span class="o">//</span> <span class="n">gran</span><span class="p">)</span> <span class="o">*</span> <span class="n">gran</span><span class="w"> </span> <span class="k">if</span> <span class="n">hour</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="n">hour</span> <span class="o">=</span> <span class="mi">24</span><span class="w"> </span> <span class="k">return</span> <span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">format_time</span><span class="p">(</span><span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">minute</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="n">time</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">hour</span><span class="si">:</span><span class="s2">02</span><span class="si">}</span><span class="s2">h</span><span class="si">{</span><span class="n">minute</span><span class="si">:</span><span class="s2">02</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">time</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">hour</span><span class="si">:</span><span class="s2">02</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span> <span class="k">return</span> <span class="n">time</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_current</span><span class="p">():</span><span class="w"> </span> <span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span> <span class="o">=</span> <span class="n">get_cur_wday_time</span><span class="p">()</span><span class="w"> </span> <span class="k">return</span> <span class="n">get_sched</span><span class="p">(</span><span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="p">)</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_sched</span><span class="p">(</span><span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="p">):</span><span class="w"> </span> <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">minute</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="n">gran</span><span class="p">):</span><span class="w"> </span> <span class="k">try</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="n">scheds</span><span class="p">[</span><span class="n">weekday</span><span class="p">][</span><span class="n">format_time</span><span class="p">(</span><span class="n">hour</span><span class="p">,</span> <span class="n">m</span><span class="p">)]</span><span class="w"> </span> <span class="k">except</span><span class="p">:</span><span class="w"> </span> <span class="k">pass</span><span class="w"> </span> <span class="k">for</span> <span class="n">h</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">hour</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">):</span><span class="w"> </span> <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">max_minute</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="n">gran</span><span class="p">):</span><span class="w"> </span> <span class="k">try</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="n">scheds</span><span class="p">[</span><span class="n">weekday</span><span class="p">][</span><span class="n">format_time</span><span class="p">(</span><span class="n">h</span><span class="p">,</span> <span class="n">m</span><span class="p">)]</span><span class="w"> </span> <span class="k">except</span><span class="p">:</span><span class="w"> </span> <span class="k">pass</span><span class="w"> </span> <span class="k">return</span> <span class="s1">''</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_new</span><span class="p">():</span><span class="w"> </span> <span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span> <span class="o">=</span> <span class="n">get_cur_wday_time</span><span class="p">()</span><span class="w"> </span> <span class="k">try</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="n">scheds</span><span class="p">[</span><span class="n">weekday</span><span class="p">][</span><span class="n">format_time</span><span class="p">(</span><span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="p">)]</span><span class="w"> </span> <span class="k">except</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="s1">''</span> </pre> <p><code class="docutils literal">get_current()</code> retorna a ação atual da rotina com base na hora e dia atuais. <code class="docutils literal">get_new()</code> faz o mesmo, mas apenas se a ação acabou de começar. Por exemplo, se &quot;Piano&quot; vai das 3 até às 4 da tarde, e considerando uma granularidade de 30 minutos (que eu estou usando atualmente), ela vai retornar &quot;Piano&quot; apenas entre 3 e 3:30 da tarde.</p> <p>Para que eu sempre possa facilmente ver qual é a ação atual com base na minha rotina, eu tenho um bloco do <a class="reference external" href="https://vivien.github.io/i3blocks/">i3blocks</a> específico para isso na barra do meu sistema:</p> <img alt="Barra do sistema mostrando a ação atual da rotina: &quot;Piano&quot;" src="/images/org/i3blocks_sched.png" /> <p>Ele simplesmente chama o <code class="docutils literal">get_current()</code> do módulo python anterior.</p> <p>Mas apenas saber a ação atual não é o suficiente, eu preciso ser notificado quando a ação atual da rotina mudar. É por isso que eu também tenho um <em>job</em> do cron que roda a cada 30 minutos e executa a <code class="docutils literal">get_new()</code> para checar se a ação atual da rotina mudou e se sim, me mostra uma notificação:</p> <img alt="Notificação mostrando a ação atual com base na rotina: &quot;Schedule change: Piano&quot;" src="/images/org/schedule_notf.png" /> <p>Por fim, também é útil ver a rotina completa da semana de vez em quando, então eu também tenho um script que mostra ela no terminal, usando uma cor diferente para cada ação na rotina, e com as cores definidas aleatoriamente (então elas mudam a cada execução do programa):</p> <pre class="code python literal-block"> <span class="ch">#!/bin/python</span><span class="w"> </span><span class="kn">import</span><span class="w"> </span><span class="nn">schedule</span><span class="w"> </span><span class="kn">import</span><span class="w"> </span><span class="nn">colored</span><span class="w"> </span><span class="n">weekday_name</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;2a&quot;</span><span class="p">,</span> <span class="s2">&quot;3a&quot;</span><span class="p">,</span> <span class="s2">&quot;4a&quot;</span><span class="p">,</span> <span class="s2">&quot;5a&quot;</span><span class="p">,</span> <span class="s2">&quot;6a&quot;</span><span class="p">,</span> <span class="s2">&quot;Sáb&quot;</span><span class="p">,</span> <span class="s2">&quot;Dom&quot;</span><span class="p">]</span><span class="w"> </span><span class="n">color</span> <span class="o">=</span> <span class="kc">True</span><span class="w"> </span><span class="nb">print</span><span class="p">(</span><span class="s2">&quot; &quot;</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="s1">''</span><span class="p">)</span><span class="w"> </span><span class="k">for</span> <span class="n">weekday</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">7</span><span class="p">):</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">weekday_name</span><span class="p">[</span><span class="n">weekday</span><span class="p">]</span><span class="si">:</span><span class="s2">15</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="s1">''</span><span class="p">)</span><span class="w"> </span><span class="nb">print</span><span class="p">()</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_color</span><span class="p">(</span><span class="n">text</span><span class="p">):</span><span class="w"> </span> <span class="n">hex_num</span> <span class="o">=</span> <span class="nb">hex</span><span class="p">(</span><span class="nb">hash</span><span class="p">(</span><span class="n">text</span><span class="p">)</span> <span class="o">%</span> <span class="p">(</span><span class="mi">16</span> <span class="o">**</span> <span class="mi">6</span><span class="p">))</span><span class="w"> </span> <span class="n">hex_num6</span> <span class="o">=</span> <span class="n">hex_num</span><span class="p">[:</span><span class="mi">2</span><span class="p">]</span> <span class="o">+</span> <span class="n">hex_num</span><span class="p">[</span><span class="mi">2</span><span class="p">:]</span><span class="o">.</span><span class="n">rjust</span><span class="p">(</span><span class="mi">6</span><span class="p">,</span> <span class="s1">'0'</span><span class="p">)</span><span class="w"> </span> <span class="k">return</span> <span class="n">hex_num6</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s1">'0x'</span><span class="p">,</span> <span class="s1">'#'</span><span class="p">)</span><span class="w"> </span><span class="k">for</span> <span class="n">hour</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">8</span><span class="p">,</span> <span class="mi">25</span><span class="p">):</span><span class="w"> </span> <span class="k">for</span> <span class="n">minute</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">schedule</span><span class="o">.</span><span class="n">max_minute</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">schedule</span><span class="o">.</span><span class="n">gran</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">hour</span> <span class="o">==</span> <span class="mi">24</span> <span class="ow">and</span> <span class="n">minute</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="k">break</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">schedule</span><span class="o">.</span><span class="n">format_time</span><span class="p">(</span><span class="n">hour</span><span class="p">,</span><span class="w"> </span><span class="n">minute</span><span class="p">)</span><span class="si">:</span><span class="s2">5</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">+</span> <span class="s2">&quot; &quot;</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="s1">''</span><span class="p">)</span><span class="w"> </span> <span class="k">for</span> <span class="n">weekday</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">7</span><span class="p">):</span><span class="w"> </span> <span class="n">text</span> <span class="o">=</span> <span class="n">schedule</span><span class="o">.</span><span class="n">get_sched</span><span class="p">(</span><span class="n">weekday</span><span class="p">,</span> <span class="n">hour</span><span class="p">,</span> <span class="n">minute</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="n">color</span><span class="p">:</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="n">colored</span><span class="o">.</span><span class="n">stylize</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">text</span><span class="si">:</span><span class="s2">15</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">colored</span><span class="o">.</span><span class="n">fg</span><span class="p">(</span><span class="n">get_color</span><span class="p">(</span><span class="n">text</span><span class="p">))),</span><span class="w"> </span> <span class="n">end</span><span class="o">=</span><span class="s1">''</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">text</span><span class="si">:</span><span class="s2">15</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="s1">''</span><span class="p">)</span><span class="w"> </span> <span class="nb">print</span><span class="p">()</span> </pre> </div> <div class="section" id="extra-tarefas-na-barra-do-sistema"> <h2>Extra: tarefas na barra do sistema</h2> <p>Como eu já uso i3blocks como a barra do meu sistema, eu adicionei também um bloco com um resumo da situação das minhas de tarefas para me ajudar a ficar atento a elas e revisá-las regularmente (e não apenas durante a revisão semanal):</p> <img alt="Barra do sistema mostrando um resumo das tarefas" src="/images/org/i3blocks_task.png" /> <p>O texto no começo mostra o contexto atual, nesse caso, <code class="docutils literal">sp</code>. Os três números seguintes são o número de tarefas <code class="docutils literal">in</code> pendentes (em amarelo), o número de projetos &quot;empacados&quot; (em magenta) e o número de tarefas com prazo final para essa semana (em vermelho).</p> </div> <div class="section" id="melhorias-futuras"> <h2>Melhorias futuras</h2> <p>E isso é tudo sobre meu sistema de organização. É basicamente o VIT sobre o Taskwarrior para organizar minhas tarefas, o calcurse para mostrar meu calendário, e blocos na barra do sistema e notificações para me ajudar a acompanhar e para avisar sobre as tarefas, rotina e compromissos.</p> <p>Esse sistema funciona bem, mas ainda há melhorias possíveis. Principalmente integração com o meu celular. Como eu mencionei anteriormente, isso não é um problema no momento já que estou sempre em casa, mas assim que a pandemia acabar, eu preciso de um bom jeito de ter minhas tarefas no celular, e sincronizadas com o meu computador. Eu preciso no mínimo poder facilmente adicionar tarefas <code class="docutils literal">in</code>, e ver meus relatórios, opcionalmente com algum filtro. Também vou precisar de um calendário com a mesma integração com o Taskwarrior que eu tenho no computador. Quem sabe com todo o <a class="reference external" href="https://puri.sm/posts/converging-on-convergence-pureos-is-convergent-welcome-to-the-future/">movimento de &quot;Convergência&quot; acontecendo na Purism</a>, eu acabe comprando um Librem 5 e tendo um sistema bem parecido nos dois dispositivos 😃.</p> </div> Gerenciando minhas tarefas usando o VIT2020-12-22T00:00:00-03:002020-12-22T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-12-22:/pt-br/post/gerenciando-minhas-tarefas-usando-o-vit.html<p>Dois anos atrás eu decidi organizar melhor minha vida. Durante esse tempo eu li o livro <a class="reference external" href="https://pt.wikipedia.org/wiki/Getting_Things_Done">Getting Things Done</a> e descobri o <a class="reference external" href="https://taskwarrior.org/">Taskwarrior</a>, um gerenciador de tarefas para o terminal que não atrapalha.</p> <p>Eu apreciei bastante a simplicidade e customizabilidade do Taskwarrior, mas depois de algum tempo, precisar digitar um …</p><p>Dois anos atrás eu decidi organizar melhor minha vida. Durante esse tempo eu li o livro <a class="reference external" href="https://pt.wikipedia.org/wiki/Getting_Things_Done">Getting Things Done</a> e descobri o <a class="reference external" href="https://taskwarrior.org/">Taskwarrior</a>, um gerenciador de tarefas para o terminal que não atrapalha.</p> <p>Eu apreciei bastante a simplicidade e customizabilidade do Taskwarrior, mas depois de algum tempo, precisar digitar um comando para cada ação, como <code class="docutils literal">task list</code> para listar as tarefas, se torna cansativo. Mesmo usando apelidos para encurtar os comandos, como <code class="docutils literal">tl</code> para <code class="docutils literal">task list</code>.</p> <p>Buscando uma TUI para o Taskwarrior, eu encontrei o <a class="reference external" href="https://github.com/vit-project/vit/tree/2.x">VIT</a>. Eu na verdade só fiquei no VIT mesmo na segunda tentativa, já que na primeira vez que eu o encontrei, ele era escrito em Perl e não era uma interface muita boa. Mas com o lançamento do VIT 2.0 reescrito em python pelo <a class="reference external" href="https://github.com/thehunmonkgroup">thehunmonkgroup</a>, ele se tornou a interface perfeita para o Taskwarrior.</p> <p>Antes de eu começar a explicar sobre a minha configuração, tenha em mente que eu não vou entrar em detalhes sobre o GTD em si, então se você não estiver familiarizado com ele, talvez dê uma olhada em <a class="reference external" href="https://hamberg.no/gtd">GTD in 15 minutes</a>. As coisas vão fazer mais sentido.</p> <div class="section" id="configuracao-do-taskwarrior"> <h2>Configuração do Taskwarrior</h2> <p>Para organizar minhas tarefas seguindo o método GTD, eu preciso adicionar alguns atributos (chamados <a class="reference external" href="https://taskwarrior.org/docs/udas.html">UDAs</a>) e relatórios personalizados no meu arquivo de configuração do Taskwarrior (<code class="docutils literal">.taskrc</code>).</p> <p>As minhas definições de UDAs são as seguintes:</p> <pre class="code ini literal-block"> <span class="na">uda.type.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Type</span><span class="w"> </span><span class="na">uda.type.values</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">in,next,objective,someday,standby,cal</span><span class="w"> </span><span class="na">uda.priority.values</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">H,L,</span><span class="w"> </span><span class="na">urgency.uda.priority.H.coefficient</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">6.0</span><span class="w"> </span><span class="na">urgency.uda.priority.L.coefficient</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">-6.0</span><span class="w"> </span><span class="na">uda.difficulty.type</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">string</span><span class="w"> </span><span class="na">uda.difficulty.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Difficulty</span><span class="w"> </span><span class="na">uda.difficulty.values</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">H,L,</span> </pre> <p>Isso adiciona três atributos diferentes. O primeiro e mais importante é o atributo <code class="docutils literal">type</code>. Eu uso ele para atribuir uma tarefa a uma das principais listas do GTD:</p> <ul class="simple"> <li><code class="docutils literal">in</code> atribui a tarefa à lista &quot;In&quot;, de entrada, onde eu coleto as tarefas inicialmente para tirá-las da minha cabeça.</li> <li><code class="docutils literal">next</code> a coloca na lista &quot;Next actions&quot;, de próximas ações, onde vivem as próximas tarefas que eu preciso fazer.</li> <li><code class="docutils literal">objective</code> a atribui à lista &quot;Projects&quot;, de projetos, onde cada tarefa descreve o objetivo de um dos meus projetos atuais, e guia a criação das tarefas em &quot;Next actions&quot; para cada um dos projetos.</li> <li><code class="docutils literal">someday</code> coloca a tarefa na lista &quot;Some day/maybe&quot;. Tarefas colocadas lá não precisam ser feitas logo, e podem até ser ideias incertas que talvez nunca sejam feitas. Apesar disso, quando eu tenho certeza de que não quero fazer uma tarefa, ela é deletada.</li> <li><code class="docutils literal">standby</code> a atribui à lista &quot;Waiting for&quot;. É nela que as tarefas que dependem da ação de outras pessoas ficam esperando.</li> <li><code class="docutils literal">cal</code> coloca a tarefa na lista &quot;Calendar&quot;, para que ela apareça no meu calendário, e com a data configurada.</li> </ul> <p>O outro atributo é o <code class="docutils literal">priority</code>, que eu uso para priorizar tarefas. Sem prioridade significa prioridade média. <code class="docutils literal">H</code> significa prioridade alta, e <code class="docutils literal">L</code>, prioridade baixa, e eles aumentam e diminuem a urgência da tarefa, respectivamente. O relatório <code class="docutils literal">next</code> ordena as tarefas por urgência, então colocar prioridade alta faz a tarefa aparecer mais alto no relatório, fazendo com que chame mais minha atenção quando eu estiver passando pelo relatório de cima para baixo procurando a próxima tarefa para fazer.</p> <p>O último atributo é o <code class="docutils literal">difficulty</code>, que indica a dificuldade da tarefa, ou seja, quanta energia me custa para completá-la. Atualmente, eu raramente o uso, mas a ideia é poder, por exemplo, filtrar o relatório <code class="docutils literal">next</code> com apenas as tarefas com <code class="docutils literal">difficulty</code> igual a <code class="docutils literal">L</code> (ou seja, as fáceis) sempre que eu estiver cansado.</p> <p>Eu também penso em adicionar uma UDA <code class="docutils literal">duration</code> para indicar, também usando <code class="docutils literal">H</code> ou <code class="docutils literal">L</code>, se a tarefa gasta mais ou menos tempo do que o normal para completar, para eu poder filtrar as tarefas com base no tempo que eu tiver disponível. Mas até o momento eu ainda não senti necessidade de adicioná-la.</p> <p>Depois, tem os relatórios:</p> <pre class="code ini literal-block"> <span class="na">report.next.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,start.age,priority,project,tags,recur,scheduled.countdown,due.relative,until.remaining,description.count,urgency</span><span class="w"> </span><span class="na">report.next.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Active,P,Project,Tag,Recur,S,Due,Until,Description,Urg</span><span class="w"> </span><span class="na">report.next.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">urgency-</span><span class="w"> </span><span class="na">report.all.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,status.short,uuid.short,start.active,entry.age,end.age,type,depends.indicator,priority,project,tags.count,recur.indicator,wait.remaining,scheduled.remaining,due,until.remaining,description</span><span class="w"> </span><span class="na">report.all.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,St,UUID,A,Age,Done,Type,D,P,Project,Tags,R,Wait,Sch,Due,Until,Description</span><span class="w"> </span><span class="na">report.all_valid.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,status.short,uuid.short,start.active,entry.age,end.age,type,depends.indicator,priority,project,tags.count,recur.indicator,wait.remaining,scheduled.remaining,due,until.remaining,description</span><span class="w"> </span><span class="na">report.all_valid.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,St,UUID,A,Age,Done,Type,D,P,Project,Tags,R,Wait,Sch,Due,Until,Description</span><span class="w"> </span><span class="na">report.all_valid.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">(status:pending or status:waiting)</span><span class="w"> </span><span class="na">report.in.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,description</span><span class="w"> </span><span class="na">report.in.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Inbox</span><span class="w"> </span><span class="na">report.in.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:pending limit:page (type:in)</span><span class="w"> </span><span class="na">report.in.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Description</span><span class="w"> </span><span class="na">report.someday.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,description.count</span><span class="w"> </span><span class="na">report.someday.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Someday/Maybe</span><span class="w"> </span><span class="na">report.someday.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">limit: type:someday status:pending</span><span class="w"> </span><span class="na">report.someday.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Description</span><span class="w"> </span><span class="na">report.standby.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,priority,project,due.relative,description.count,urgency</span><span class="w"> </span><span class="na">report.standby.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">WaitingFor</span><span class="w"> </span><span class="na">report.standby.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,P,Project,Due,Description,Urgency</span><span class="w"> </span><span class="na">report.standby.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">limit: type:standby status:pending +READY</span><span class="w"> </span><span class="na">report.standby.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">urgency-</span><span class="w"> </span><span class="na">report.objectives.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,priority,project,description.count,urgency</span><span class="w"> </span><span class="na">report.objectives.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Projects</span><span class="w"> </span><span class="na">report.objectives.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,P,Project,Description,Urgency</span><span class="w"> </span><span class="na">report.objectives.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">limit: type:objective status:pending +UNBLOCKED</span><span class="w"> </span><span class="na">report.objectives.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">urgency-</span><span class="w"> </span><span class="na">report.type.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,description,type</span><span class="w"> </span><span class="na">report.type.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Type</span><span class="w"> </span><span class="na">report.type.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:pending limit:page</span><span class="w"> </span><span class="na">report.type.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Description,Type</span><span class="w"> </span><span class="na">report.cal.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,entry.age,recur.indicator,scheduled,due,description</span><span class="w"> </span><span class="na">report.cal.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Calendar</span><span class="w"> </span><span class="na">report.cal.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">type:cal status:pending limit:page</span><span class="w"> </span><span class="na">report.cal.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Age,R,Scheduled,Due,Description</span><span class="w"> </span><span class="na">report.cal.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">scheduled</span> </pre> <p>Eu tenho um relatório para cada um dos tipos mencionados para que eu possa ver a lista de tarefas para cada um deles: <code class="docutils literal">in</code>, <code class="docutils literal">next</code>, <code class="docutils literal">objectives</code> (com um 's'), <code class="docutils literal">someday</code>, <code class="docutils literal">standby</code> e <code class="docutils literal">cal</code>. Além disso, também há o relatório <code class="docutils literal">all</code> que mostra <em>todas</em> as tarefas, o <code class="docutils literal">all_valid</code> que é igual ao <code class="docutils literal">all</code> mas não mostra as tarefas concluídas e deletadas, e o relatório <code class="docutils literal">type</code> que mostra cada uma das tarefas e seu tipo.</p> </div> <div class="section" id="configuracao-do-vit"> <h2>Configuração do VIT</h2> <p>Se configurar o Taskwarrior consiste em configurar os atributos e relatórios para permitir o meu fluxo de trabalho, configurar o VIT consiste em configurar os atalhos para tornar esse fluxo o mais fluido possível.</p> <p>Os meus atalhos (que são definidos no arquivo <code class="docutils literal">config.ini</code> dentro da pasta <code class="docutils literal">.vit</code>) são os seguintes:</p> <pre class="code ini literal-block"> <span class="na">q</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">{ACTION_QUIT}</span><span class="w"> </span><span class="na">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">{ACTION_NOOP}</span><span class="w"> </span><span class="na">aa</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">{ACTION_TASK_ADD}</span><span class="w"> </span><span class="na">ai</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:in&lt;Space&gt;</span><span class="w"> </span><span class="na">an</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:next&lt;Space&gt;</span><span class="w"> </span><span class="na">ap</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:objective project:</span><span class="w"> </span><span class="na">as</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:someday&lt;Space&gt;</span><span class="w"> </span><span class="na">aw</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:standby&lt;Space&gt;</span><span class="w"> </span><span class="na">ac</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:cal schedule:</span><span class="w"> </span><span class="na">aN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:next project:{TASK_PROJECT}&lt;Space&gt;</span><span class="w"> </span><span class="na">aP</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aaproject:{TASK_PROJECT}&lt;Space&gt;</span><span class="w"> </span><span class="na">gi</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:in&lt;Enter&gt;</span><span class="w"> </span><span class="na">gn</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:next&lt;Enter&gt;</span><span class="w"> </span><span class="na">gp</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:objectives&lt;Enter&gt;</span><span class="w"> </span><span class="na">gs</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:someday&lt;Enter&gt;</span><span class="w"> </span><span class="na">gw</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:standby&lt;Enter&gt;</span><span class="w"> </span><span class="na">gc</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:cal&lt;Enter&gt;</span><span class="w"> </span><span class="na">gl</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:list&lt;Enter&gt;</span><span class="w"> </span><span class="na">ga</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:all_valid&lt;Enter&gt;</span><span class="w"> </span><span class="na">gA</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:all&lt;Enter&gt;</span><span class="w"> </span><span class="na">gP</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:all_valid project:{TASK_PROJECT}&lt;Enter&gt;</span><span class="w"> </span><span class="na">M</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">m{TASK_DESCRIPTION}</span><span class="w"> </span><span class="na">S</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r task modify type:someday {TASK_UUID}&lt;Enter&gt;</span><span class="w"> </span><span class="na">W</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r task modify type:standby {TASK_UUID}&lt;Enter&gt;</span><span class="w"> </span><span class="na">P</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r task modify {TASK_UUID} priority:</span><span class="w"> </span><span class="na">F</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r task modify {TASK_UUID} difficulty:</span><span class="w"> </span><span class="na">Y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r task duplicate {TASK_UUID}&lt;Enter&gt;</span><span class="w"> </span><span class="c1">#$ = :!r task sync&lt;Enter&gt;</span><span class="w"> </span><span class="na">zp</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">gpf{STUCK_PROJS}&lt;Enter&gt;</span><span class="w"> </span><span class="na">o</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:! taskopen {TASK_UUID}&lt;Enter&gt;</span><span class="w"> </span><span class="na">C</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:!r taskwarrior-update_context&lt;Enter&gt;</span><span class="w"> </span><span class="c1"># Convenience mappings</span><span class="w"> </span><span class="na">1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:1</span><span class="w"> </span><span class="na">2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:2</span><span class="w"> </span><span class="na">3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:3</span><span class="w"> </span><span class="na">4</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:4</span><span class="w"> </span><span class="na">5</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:5</span><span class="w"> </span><span class="na">6</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:6</span><span class="w"> </span><span class="na">7</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:7</span><span class="w"> </span><span class="na">8</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:8</span><span class="w"> </span><span class="na">9</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">:9</span><span class="w"> </span><span class="na">-</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">m-</span><span class="w"> </span><span class="na">+</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">m+</span> </pre> <p>Os atalhos principais são os que começam com <code class="docutils literal">a</code> ou <code class="docutils literal">g</code>. Esses são os que eu uso o dia todo. Os que começam com <code class="docutils literal">a</code> são para adicionar tarefas, com um deles para cada tipo, para que eu possa rapidamente adicionar uma tarefa de qualquer tipo. Já os que começam com <code class="docutils literal">g</code> são para ir para um relatório, então eu também consigo rapidamente mudar para um relatório específico e ver as tarefas desse tipo.</p> <p>Mas alguns deles são especiais. Por exemplo, <code class="docutils literal">aN</code> adiciona uma tarefa do tipo <code class="docutils literal">next</code> e com o projeto igual ao da tarefa atualmente selecionada. Eu uso isso quando eu estou revisando meus projetos atuais no relatório <code class="docutils literal">objectives</code> e quero adicionar uma tarefa para a próxima ação do projeto que está selecionado.</p> <p><code class="docutils literal">gP</code> é outro que eu uso bastante. Ele mostra todas as tarefas com o mesmo projeto da tarefa atualmente selecionada. Eu uso isso quando estou olhando uma tarefa de um projeto e quero ver todas as outras tarefas desse projeto, como o objetivo definido pela tarefa <code class="docutils literal">objective</code>, as próximas ações mostradas pelas tarefas <code class="docutils literal">next</code>, se há coisas esperando por outras pessoas em <code class="docutils literal">standby</code> ou algo marcado no calendário em <code class="docutils literal">cal</code>.</p> <p>Aí vem alguns atalhos de utilidades usados menos frequentemente. <code class="docutils literal">M</code> edita a descrição da tarefa selecionada. <code class="docutils literal">S</code> e <code class="docutils literal">W</code> mudam o tipo da tarefa selecionada para <code class="docutils literal">someday</code> e <code class="docutils literal">standby</code>, respectivamente. O primeiro é útil quando eu decido que uma tarefa pode ser feita mais para o futuro ao invés de agora, enquanto o segundo não é muito usado. <code class="docutils literal">P</code> edita a prioridade da tarefa, enquanto <code class="docutils literal">F</code>, sua dificuldade. <code class="docutils literal">Y</code> duplica a tarefa selecionada.</p> <p>O <code class="docutils literal">$</code> que está comentado é usado para sincronizar as tarefas para um servidor do Taskwarrior central usando o Taskserver. Era essencial para manter as tarefas sincronizadas entre meu computador e meu celular mesmo quando eu saía. Mas como ultimamente sair não tem sido uma atividade frequente, fazendo com que eu sempre esteja no meu computador, eu desabilitei esse atalho por enquanto.</p> <p>O atalho <code class="docutils literal">zp</code> é um que é um pouco mais complicado, mas <em>muito</em> útil. Ele vai para o relatório <code class="docutils literal">objectives</code>, que mostra meus projetos atuais, e filtra para que só os projetos <em>sem</em> tarefas <code class="docutils literal">next</code> sejam mostrados. É importante no GTD sempre garantir que todos os seus projetos tenham próximas ações atribuídas a eles, para que o próximo passo para avançá-los seja óbvio. Com esse atalho, durante minha revisão semanal de todas as tarefas, eu posso facilmente ver quais projetos não possuem próximas ações e então criar uma para cada projeto usando o <code class="docutils literal">aN</code> já mostrado. Se você estiver se perguntando o que o <code class="docutils literal">{STUCK_PROJS}</code> significa, não se preocupe, eu já vou explicá-lo.</p> <p><code class="docutils literal">o</code> usa o <a class="reference external" href="https://github.com/jschlatow/taskopen">taskopen</a> na tarefa atualmente selecionada, e esse é outro que eu uso o tempo todo. O que o taskopen faz é ler as anotações da tarefa e abrir uma delas (perguntando qual, se houver múltiplas opções). Se a anotação for uma URL, ela vai ser aberta no navegador de internet. Se for a palavra &quot;Notes&quot;, o taskopen vai abrir o arquivo de texto associado a essa tarefa (criando ele se essa for a primeira vez) onde você pode escrever anotações mais compridas. Esses dois são os que eu conheço e uso o tempo todo. Anotações com texto normal são ignoradas pelo taskopen.</p> <p>O atalho <code class="docutils literal">C</code> roda um script para atualizar o contexto atual do Taskwarrior, mas eu normalmente não preciso rodá-lo já que ele executa automaticamente como explicado no <a class="reference external" href="/pt-br/post/deteccao-de-contexto-automatica-para-o-taskwarrior.html">artigo "Detecção de contexto automática para o Taskwarrior"</a>.</p> <p>Por fim, eu tenho alguns atalhos só por conveniência. Cada um dos dígitos mapeia para <code class="docutils literal">:</code> seguido por esse dígito, para que eu possa pular para uma tarefa pressionando uma tecla a menos. Mais detalhadamente, normalmente para pular para a tarefa de id 42 eu precisaria digitar <code class="docutils literal">:</code>, <code class="docutils literal">4</code>, <code class="docutils literal">2</code> e <code class="docutils literal">&lt;Enter&gt;</code>. Com esse atalho, eu não preciso do <code class="docutils literal">:</code>, então eu só digito <code class="docutils literal">4</code>, <code class="docutils literal">2</code> e <code class="docutils literal">&lt;Enter&gt;</code>. Como é muito comum pular para tarefas no VIT, essa uma tecla a menos vale a pena. Além disso, <code class="docutils literal">-</code> e <code class="docutils literal">+</code> mapeiam para <code class="docutils literal">m-</code> e <code class="docutils literal">m+</code>, respectivamente, sendo que <code class="docutils literal">m</code> é o comando padrão para modificar a tarefa, então para adicionar um rótulo em uma tarefa, por exemplo, eu só preciso pressionar <code class="docutils literal">+</code>, escrever o nome do rótulo e apertar <code class="docutils literal">&lt;Enter&gt;</code>.</p> <div class="section" id="substituicao-de-variavel-no-vit"> <h3>Substituição de variável no VIT</h3> <p>Você deve ter notado alguns <code class="docutils literal">{ALGUMA_COISA}</code> nos atalhos do VIT acima. Eu só queria dar uma pequena explicação sobre eles (já que uma explicação completa deve ser lida na documentação do VIT) e também mostrar a minha substituição de variável personalizada.</p> <p>Em primeiro lugar, o <code class="docutils literal">{ACTION_QUIT}</code> no atalho <code class="docutils literal">q</code> não é uma substituição de variável, apesar da sintaxe ser parecida (a diferença sendo que ela é a única coisa depois do <code class="docutils literal">=</code>). Isso é só uma das ações do VIT que podem ser mapeadas. Uma substituição de variável ocorre no atalho <code class="docutils literal">aN</code> por exemplo:</p> <div class="highlight"><pre><span></span><span class="na">aN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">aatype:next project:{TASK_PROJECT}&lt;Space&gt;</span> </pre></div> <p>Aqui, <code class="docutils literal">{TASK_PROJECT}</code> vai ser substituído pelo atributo de projeto da tarefa atualmente selecionada. Então é por isso que esse atalho faz o que ele faz. O <code class="docutils literal">aa</code> no começo está mapeado para a ação de adicionar uma nova tarefa, e então o tipo é colocado como <code class="docutils literal">next</code> e o projeto, como o projeto da tarefa selecionada. Todos os <code class="docutils literal">{TASK_*}</code> são substituições de variável já integradas do VIT, que podem ser usadas para qualquer um dos atributos das tarefas (incluindo UDAs).</p> <p>Agora, no caso do atalho <code class="docutils literal">zp</code>:</p> <div class="highlight"><pre><span></span><span class="na">zp</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">gpf{STUCK_PROJS}&lt;Enter&gt;</span> </pre></div> <p><code class="docutils literal">{STUCK_PROJS}</code> é uma substituição de variável personalizada que eu criei. Foi bem simples, eu só segui o <a class="reference external" href="https://github.com/vit-project/vit/blob/2.x/CUSTOMIZE.md#to-provide-your-own-custom-variable-replacements">CUSTOMIZE.md do VIT</a>.</p> <p>Dentro da minha pasta <code class="docutils literal">.vit</code>, eu adicionei um <code class="docutils literal">keybinding/keybinding.py</code> com o seguinte:</p> <pre class="code python literal-block"> <span class="kn">from</span><span class="w"> </span><span class="nn">task_proj_stuck</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_stuck_proj_ids</span><span class="w"> </span><span class="k">class</span><span class="w"> </span><span class="nc">Keybinding</span><span class="p">():</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">replacements</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">_custom_match</span><span class="p">(</span><span class="n">variable</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">variable</span> <span class="ow">in</span> <span class="p">[</span><span class="s1">'STUCK_PROJS'</span><span class="p">]:</span><span class="w"> </span> <span class="k">return</span> <span class="p">[</span><span class="n">variable</span><span class="p">]</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">_custom_replace</span><span class="p">(</span><span class="n">task</span><span class="p">,</span> <span class="n">arg</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">arg</span> <span class="o">==</span> <span class="s1">'STUCK_PROJS'</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="s1">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">get_stuck_proj_ids</span><span class="p">()))</span><span class="w"> </span> <span class="k">return</span> <span class="p">[</span><span class="w"> </span> <span class="p">{</span><span class="w"> </span> <span class="s1">'match_callback'</span><span class="p">:</span> <span class="n">_custom_match</span><span class="p">,</span><span class="w"> </span> <span class="s1">'replacement_callback'</span><span class="p">:</span> <span class="n">_custom_replace</span><span class="p">,</span><span class="w"> </span> <span class="p">},</span><span class="w"> </span> <span class="p">]</span> </pre> <p>E eu tenho um módulo python <code class="docutils literal">task_proj_stuck</code> com o seguinte:</p> <pre class="code python literal-block"> <span class="kn">from</span><span class="w"> </span><span class="nn">tasklib</span><span class="w"> </span><span class="kn">import</span> <span class="n">TaskWarrior</span><span class="w"> </span><span class="n">tw</span> <span class="o">=</span> <span class="n">TaskWarrior</span><span class="p">()</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_stuck_projects</span><span class="p">():</span><span class="w"> </span><span class="sd">&quot;&quot;&quot; Get taskwarrior projects that don't have any next actions assigned to them. Next actions here mean actions of type 'next', 'standby' or 'cal', either pending or waiting. &quot;&quot;&quot;</span><span class="w"> </span> <span class="n">projects</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">pending</span><span class="p">()</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'+READY'</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="s1">'objective'</span><span class="p">)</span><span class="w"> </span> <span class="n">next_tasks</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'(status:pending or status:waiting) and type:next'</span><span class="p">)</span><span class="w"> </span> <span class="n">standby_tasks</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'(status:pending or status:waiting) and type:standby'</span><span class="p">)</span><span class="w"> </span> <span class="n">cal_tasks</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="s1">'(status:pending or status:waiting) and type:cal'</span><span class="p">)</span><span class="w"> </span> <span class="k">for</span> <span class="n">project</span> <span class="ow">in</span> <span class="n">projects</span><span class="p">:</span><span class="w"> </span> <span class="n">count_next</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">next_tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project</span><span class="p">[</span><span class="s1">'project'</span><span class="p">]))</span><span class="w"> </span> <span class="n">count_standby</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">standby_tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project</span><span class="p">[</span><span class="s1">'project'</span><span class="p">]))</span><span class="w"> </span> <span class="n">count_cal</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">cal_tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">project</span><span class="o">=</span><span class="n">project</span><span class="p">[</span><span class="s1">'project'</span><span class="p">]))</span><span class="w"> </span> <span class="k">if</span> <span class="n">count_next</span> <span class="o">+</span> <span class="n">count_standby</span> <span class="o">+</span> <span class="n">count_cal</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span><span class="w"> </span> <span class="k">yield</span> <span class="n">project</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">get_stuck_proj_ids</span><span class="p">():</span><span class="w"> </span> <span class="k">return</span> <span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">project</span><span class="p">[</span><span class="s1">'id'</span><span class="p">])</span> <span class="k">for</span> <span class="n">project</span> <span class="ow">in</span> <span class="n">get_stuck_projects</span><span class="p">())</span> </pre> <p>Então o que acontece é que a função <code class="docutils literal">get_stuck_proj_ids()</code> retorna um gerador contendo o id de cada tarefa <code class="docutils literal">objective</code> cujo projeto não possui nenhuma tarefa <code class="docutils literal">next</code>. A substituição de variável <code class="docutils literal">{STUCK_PROJS}</code> então apenas chama essa função e junta os ids usando espaço.</p> <p>Por exemplo, suponha que existem os projetos <code class="docutils literal">limpar-quarto</code> e <code class="docutils literal">escrever-artigo-vit</code>. A tarefa <code class="docutils literal">objective</code> do projeto <code class="docutils literal">limpar-quarto</code> tem id 42 e a tarefa do projeto <code class="docutils literal">escrever-artigo-vit</code> tem id 99. Ambos os projetos não tem nenhuma tarefa <code class="docutils literal">next</code>, enquanto todos os outros projetos têm. Então, pressionando <code class="docutils literal">zp</code>, o VIT vai executar <code class="docutils literal">gpf42 99&lt;Enter&gt;</code>, que vai para o relatório <code class="docutils literal">objectives</code> e filtra apenas pelas tarefas 42 e 99, para que eu possa focar em adicionar as próximas tarefas para cada um desses projetos empacados com <code class="docutils literal">aN</code>. Bem conveniente, não?</p> </div> </div> <div class="section" id="hooks-e-taskpirate"> <h2><em>Hooks</em> e taskpirate</h2> <p>Outra poderosa funcionalidade do Taskwarrior que permite extensibilidade é a <a class="reference external" href="https://taskwarrior.org/docs/hooks.html">API de hooks</a>. Se você já usou Git, talvez já esteja familiarizado com esse conceito. Ele permite que um script personalizado execute quando um certo evento ocorrer no programa, nesse caso, no Taskwarrior.</p> <p>Ao invés de criar um <em>hook</em> diretamente no Taskwarrior, eu decidi usar o <a class="reference external" href="https://github.com/tbabej/taskpirate">taskpirate</a>, que torna as tarefas mais diretamente acessíveis em python. E como você já deve saber, <a class="reference external" href="https://nfraprado.net/pt-br/tag/python.html">eu gosto de python</a>.</p> <p>Atualmente eu tenho um único <em>hook</em> chamado <code class="docutils literal">pirate_add_inherit.py</code>, dentro da pasta <code class="docutils literal">hooks</code>, e o que ele faz é tornar certos atributos herdáveis da tarefa <code class="docutils literal">objectives</code> de um projeto. O código é o seguinte:</p> <pre class="code python literal-block"> <span class="ch">#!/bin/python</span><span class="w"> </span><span class="kn">from</span><span class="w"> </span><span class="nn">tasklib</span><span class="w"> </span><span class="kn">import</span> <span class="n">TaskWarrior</span><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">hook_inherit</span><span class="p">(</span><span class="n">task</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">task</span><span class="p">[</span><span class="s1">'project'</span><span class="p">]</span> <span class="ow">and</span> <span class="n">task</span><span class="p">[</span><span class="s1">'type'</span><span class="p">]</span> <span class="o">!=</span> <span class="s1">'objective'</span><span class="p">:</span><span class="w"> </span> <span class="n">tw</span> <span class="o">=</span> <span class="n">TaskWarrior</span><span class="p">(</span><span class="s1">'/home/nfraprado/.task/data'</span><span class="p">)</span><span class="w"> </span> <span class="k">try</span><span class="p">:</span><span class="w"> </span> <span class="n">obj_task</span> <span class="o">=</span> <span class="n">tw</span><span class="o">.</span><span class="n">tasks</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">type</span><span class="o">=</span><span class="s1">'objective'</span><span class="p">,</span> <span class="n">project</span><span class="o">=</span><span class="n">task</span><span class="p">[</span><span class="s1">'project'</span><span class="p">])[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span> <span class="k">except</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span><span class="w"> </span> <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="p">(</span><span class="s1">'due'</span><span class="p">,</span> <span class="s1">'priority'</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="ow">not</span> <span class="n">task</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> <span class="ow">and</span> <span class="n">obj_task</span><span class="p">[</span><span class="n">field</span><span class="p">]:</span><span class="w"> </span> <span class="n">task</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> <span class="o">=</span> <span class="n">obj_task</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> </pre> <p>Como ele é um <em>hook</em> <code class="docutils literal">add</code>, ele executa toda vez que uma nova tarefa é criada. O que ele faz é o seguinte: sempre que uma tarefa é criada com um projeto, seus atributos <code class="docutils literal">due</code> e <code class="docutils literal">priority</code> são colocados iguais aos valores que tiverem na tarefa <code class="docutils literal">objective</code> do projeto, a não ser que eles tenham sido configurados explicitamente na nova tarefa.</p> </div> <div class="section" id="demonstracao"> <h2>Demonstração</h2> <p>Depois de falar tanto, eu te devo no mínimo alguns gifs mostrando como tudo isso funciona. Vale dizer que as tarefas mostradas a seguir não são minhas tarefas reais, caso contrário você veria mais de cem no relatório <code class="docutils literal">someday</code>, por exemplo.</p> <p>No primeiro gif, eu mudo para cada um dos relatórios (<code class="docutils literal">next</code>, <code class="docutils literal">in</code>, <code class="docutils literal">standby</code>, <code class="docutils literal">objectives</code> e <code class="docutils literal">someday</code>) usando os atalhos <code class="docutils literal">g</code>, e então adiciono uma tarefa <code class="docutils literal">in</code> usando <code class="docutils literal">ai</code> e em seguida uso <code class="docutils literal">S</code> para movê-la para <code class="docutils literal">someday</code>. Eu também uso o atalho padrão <code class="docutils literal">&lt;Enter&gt;</code> para inspecionar a tarefa. Você também pode me ver pulando para tarefas usando usando o id e pesquisando por uma string usando o atalho padrão <code class="docutils literal">/</code>.</p> <img alt="Navegação e criação de tarefas no VIT usando meus atalhos personalizados" src="/images/vit/vit1_br.gif" /> <p><a class="reference external" href="https://asciinema.org/a/380696">Em asciinema.org</a></p> <p>Nesse segundo gif, eu uso o atalho padrão <code class="docutils literal">A</code> para anotar uma tarefa com um texto simples e em seguida com a string &quot;Notes&quot;. Então eu uso <code class="docutils literal">o</code> para fazer o taskopen abrir uma nota para a tarefa onde eu escrevo mais anotações.</p> <img alt="Anotação de tarefas e uso do taskopen no VIT" src="/images/vit/vit2_br.gif" /> <p><a class="reference external" href="https://asciinema.org/a/380697">Em asciinema.org</a></p> <p>Nesse último gif, eu uso o atalho <code class="docutils literal">zp</code> para mostrar apenas os projetos empacados, e então uso <code class="docutils literal">aN</code> em dois deles para criar tarefas <code class="docutils literal">next</code>. Por fim, eu uso <code class="docutils literal">gP</code> em uma tarefa para mostrar apenas as tarefas de seu projeto. Aqui você também pode ver o efeito do <em>hook</em>, já que a tarefa <code class="docutils literal">Proxima acao 1</code> tem os mesmos valores nos atributos <code class="docutils literal">priority</code> e <code class="docutils literal">due</code> da tarefa <code class="docutils literal">Novo Projeto 1</code>, sendo que eu não os especifiquei.</p> <img alt="Uso dos meus atalhos personalizados zp, aN e gP para facilitar o acompanhamento de projetos no VIT" src="/images/vit/vit3_br.gif" /> <p><a class="reference external" href="https://asciinema.org/a/380698">Em asciinema.org</a></p> <p>E é isso. Se isso te interessou, dê uma olhada no VIT. Eu apenas mostrei meus atalhos e meu fluxo de trabalho com ele, mas o VIT é capaz de muito mais.</p> <p>Por fim, esse artigo apenas cobriu as coisas relacionadas a gerenciar tarefas e ao VIT. Ainda há outras partes importantes da minha organização para serem explicadas, como como eu vejo meu calendário e como eu mantenho uma rotina. Eu vou falar sobre elas no próximo artigo.</p> </div> Portando um driver de LED de flash para o kernel oficial2020-11-20T00:00:00-03:002020-11-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-11-20:/pt-br/post/portando-um-driver-de-led-de-flash-para-o-kernel-oficial.html<p>Agora que eu já tinha um cabo serial funcionando para o meu Nexus 5, como descrito no <a class="reference external" href="/pt-br/post/fazendo-um-cabo-uart-para-o-nexus-5.html">artigo "Fazendo um cabo UART para o Nexus 5"</a>, eu estava pronto para a ação em ajudar a trazer o Nexus 5 para o kernel oficial.</p> <p>Olhando <a class="reference external" href="https://masneyb.github.io/nexus-5-upstream/TODO.html">a página de pendências do Brian …</a></p><p>Agora que eu já tinha um cabo serial funcionando para o meu Nexus 5, como descrito no <a class="reference external" href="/pt-br/post/fazendo-um-cabo-uart-para-o-nexus-5.html">artigo "Fazendo um cabo UART para o Nexus 5"</a>, eu estava pronto para a ação em ajudar a trazer o Nexus 5 para o kernel oficial.</p> <p>Olhando <a class="reference external" href="https://masneyb.github.io/nexus-5-upstream/TODO.html">a página de pendências do Brian Masney</a> haviam algumas opções, mas a que eu decidi fazer foi a de lanterna traseira. Não tem hardware mais simples que um LED e seria fácil testar se estava funcionando.</p> <p>Mas para a minha surpresa, <a class="reference external" href="https://github.com/AICP/kernel_lge_hammerhead/blob/n7.1/drivers/leds/leds-qpnp.c">o driver no kernel derivado</a> (não-oficial) tinha mais de 3500 linhas! Mas ele não era só para o LED de flash, ele suportava múltiplos tipos de LED: WLED, Flash/Torch, RGB, MPP e KPDBL.</p> <p>Para tornar o porte mais fácil e já que o flash seria o único que eu seria capaz de testar e ter certeza de que está funcionando, eu decidi criar um novo arquivo para o driver e copiar só o que precisava para o LED de flash.</p> <p>Eu comecei copiando a função <em>probe</em>, compilando o driver e vendo quais erros de definições faltando apareciam. Se as definições tivessem &quot;flash&quot; ou &quot;torch&quot; no nome, eu também copiava elas, se não, eu só removia essas referências. Eu repeti isso até que eventualmente não haviam mais erros de definições faltando e meu driver tinha tudo que era necessário para o LED de flash.</p> <p>Apesar disso, o código ainda tinha muitos erros de compilação, já que o driver era para o kernel 3.4 (derivado) e eu estava compilando para o 5.7.6 (oficial). Então eu fui passando por cada erro, usando as definições em ambos os kernels como referência, e fazendo as mudanças necessárias.</p> <p>Com o driver compilando com sucesso, eu adicionei o CONFIG para ele e o habilitei como um módulo no <em>defconfig</em> usado pelo Nexus 5 (<code class="docutils literal">qcom_defconfig</code>). Eu também vasculhei os arquivos de <em>devicetree</em> na árvore do kernel derivado para descobrir de quais nós eu precisava para descrever o hardware do LED de flash para o driver, e as propriedades necessárias neles, para que eu pudesse adicionar isso no kernel oficial.</p> <p><strong>Obs</strong>: Por conta da forma como <em>devicetrees</em> funcionam, pode ser que propriedades de um mesmo nó estejam espalhadas por múltiplos arquivos. Só depois eu descobri que eu poderia compilar o kernel derivado e gerar o fonte da <em>devicetree</em> completa a partir do binário com <code class="docutils literal">dtc -I dtb -O dts -o downstream_dt.dts kernel_lge_hammerhead/arch/arm/boot/msm8974-hammerhead-rev-11.dtb</code>.</p> <p>Tendo um driver que compila, uma <em>devicetree</em> válida e as configurações habilitando o driver, eu estava pronto para finalmente compilar meu kernel com o driver e gravar a imagem no celular. Então eu <a class="reference external" href="https://codeberg.org/nfraprado/linux/commit/d18087e294bb176ee3ffa94f6f82dc60f4b65b63">fiz um commit com as minhas alterações</a> e fui para a batalha.</p> <p>E claro que ele falhou. Na verdade, ele falhou tanto que o driver nem se vinculou ao dispositivo do LED. Já que eu não tinha um bom entendimento de <em>devicetrees</em> e de como ocorria a vinculação entre dispositivos e drivers, eu comecei a pesquisar sobre.</p> <p>Um ótimo material que eu encontrei foi <a class="reference external" href="https://elinux.org/images/0/04/Dt_debugging_elce_2015_151006_0421.pdf">Solving Device Tree Issues</a> (<a class="reference external" href="https://elinux.org/Device_Tree_frowand">mais no eLinux</a>). Inclusive foi usando o script <code class="docutils literal">dt_node_info</code> que essa apresentação mostra que eu descobri que o dispositivo estava sendo carregado mas o driver não. Além disso, as técnicas de depuração mostradas, como habilitar prints de debug dinâmicos nas funções de <em>probe</em> me ajudaram a descobrir que a função <em>probe</em> do meu driver nem estava sendo chamada.</p> <p>Depois de ler bastante, tanto documentação online quanto código de outros drivers, eu reparei que o meu driver estava se registrando no barramento <em>SPMI</em>, o que fazia sentido para mim já que ele precisa se comunicar por esse barramento, mas já que o nó do LED de flash na <em>devicetree</em> estava sendo registrado no barramento <em>platform</em>, meu driver também precisava se registrar nele, caso contrário eles nunca iriam se vincular. Então isso era uma das coisas que eu precisava mudar.</p> <p>Mas fazer com que meu driver se registrasse no barramento <em>platform</em>, fazia com que eu não tivesse mais o ponteiro de <code class="docutils literal">spmi_device</code> que eu precisava para usar as funções de SPMI para ler e escrever nos registradores. Mais uma vez, olhando nos drivers em volta, como o <code class="docutils literal">qcom-spmi-iadc</code>, eu percebi que tinha esse tal de <em>regmap</em> que eu poderia usar para ler e escrever nos registradores por SPMI mas sem ser específico ao SPMI. Eu fiz o sensato e decidi experimentar!</p> <p>Com <a class="reference external" href="https://codeberg.org/nfraprado/linux/commit/2fc718b93bf69284e1f174397b1eb5255fd44359">essas alterações feitas</a>, o driver agora estava se vinculando ao dispositivo, mas a função <em>probe</em> estava falhando com as seguintes mensagens:</p> <div class="highlight"><pre><span></span><span class="m">[ 14.547394] </span><span class="k">spmi spmi-0:</span><span class="gr"> pmic_arb_wait_for_done: transaction failed (0x3)</span> <span class="m">[ 14.547405] </span><span class="k">qcom,leds-qpnp fc4cf000.spmi:</span>pm8941@1:qcom,leds@d300: Unable to read from addr=5, rc(-5) <span class="m">[ 14.547503] </span><span class="k">qcom,leds-qpnp fc4cf000.spmi:</span><span class="gr">pm8941@1:qcom,leds@d300: Regulator get failed(-517)</span> <span class="m">[ 14.547512] </span><span class="k">qcom,leds-qpnp fc4cf000.spmi:</span>pm8941@1:qcom,leds@d300: Unable to read flash config data </pre></div> <p>Já que era o regulador que estava falhando, e dado que eu tinha simplesmente copiado os nós dos reguladores da <em>devicetree</em> do kernel derivado, o problema claramente estava aí no meio. Eu precisava então descobrir quais reguladores que eram necessários para o LED funcionar, e adicionar eles no kernel oficial caso ainda não estivessem lá.</p> <p>Nesse momento eu enviei um email para o Brian Masney pedindo uma luz, e o conselho dele foi que eu compilasse e testasse o kernel derivado. Afinal, ter algo que funciona para servir de referência, mesmo que seja bem desatualizado, não tem preço.</p> <p>Usando uma versão mais antiga das ferramentas de compilação, como <a class="reference external" href="https://github.com/masneyb/nexus-5-upstream/blob/master/build-kernel">instruído no script de compilação</a>, e depois de <a class="reference external" href="https://github.com/masneyb/nexus-5-upstream/pull/6">um pequeno problema</a>, eu consegui compilar o kernel derivado, gravei ele e conferi que o LED e o driver derivado realmente funcionavam. Eu realmente deveria ter feito isso logo no começo... Já pensou se o próprio LED de flash estivesse com problema?</p> <p>Então eu comecei a explorar o <em>sysfs</em> desse sistema para entender como ele funcionava. Eu encontrei o regulador que estava sendo usado pelo LED, cujo <code class="docutils literal">status</code> ia para <code class="docutils literal">enabled</code> sempre que eu ligava o LED usando <code class="docutils literal">echo 1 &gt; /sys/class/leds/led\:flash_torch/brightness</code>.</p> <p>Tendo o nó do regulador e a <em>devicetree</em> no kernel derivado, e o driver do regulador (<code class="docutils literal">qcom_spmi-regulator</code>) e a <em>dtbinding</em> dele no kernel oficial, eu comecei a fazer o trabalho de detetive.</p> <p>Depois de um pouco de investigação eu finalmente descobri que, já que o endereço do regulador era <code class="docutils literal">0xa000</code>, o regulador chamado <code class="docutils literal">8941_boost</code> na árvore derivada na verdade <a class="reference external" href="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=c333dfe8dba7d3e47e97e1cee3c38123e19ae73c">é conhecido como</a> <code class="docutils literal">s4</code> na árvore oficial, ou também pelo apelido <code class="docutils literal">pm8941_5v</code>.</p> <p>Eu ainda tinha que descobrir a verdadeira identidade do outro regulador, mas agora que eu já tinha ganhado um pouco de confiança de um trabalho de detetive bem feito, e com a ajuda de algumas dicas da <em>devicetree</em>, eu apostei tudo que que a verdadeira identidade do <code class="docutils literal">pm8941_chg_boost</code> era <code class="docutils literal">5vs1</code>, também chamado de <code class="docutils literal">pm8941_5vs1</code>.</p> <p><a class="reference external" href="https://codeberg.org/nfraprado/linux/commit/e3ca691d5b726e64cab869d2dab57b835c14a5b9">Salvar</a>, gravar, testar, eeee... nada. Ainda sim não funcionou, mas eu claramente tinha progredido. Agora a função <em>probe</em> estava sendo executada com sucesso, mas as operações de leitura e escrita nos registradores SPMI ainda estavam falhando:</p> <div class="highlight"><pre><span></span><span class="m">[ 13.346704] </span><span class="k">leds_qpnp:</span>qpnp_leds_probe: Probe called! <span class="m">[ 13.346746] </span><span class="k">spmi spmi-0:</span><span class="gr"> pmic_arb_wait_for_done: transaction failed (0x3)</span> <span class="m">[ 13.346760] </span><span class="k">qcom,leds-qpnp fc4cf000.spmi:</span>pm8941@1:qcom,leds@d300: Unable to read from addr=5, rc(-5) <span class="m">[ 13.347250] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: ===== led:flash_0 LED register dump start ===== <span class="m">[ 13.347285] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x40 = 0x0 <span class="m">[ 13.347319] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x41 = 0x0 <span class="m">[ 13.347353] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x42 = 0x0 <span class="m">[ 13.347385] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x43 = 0x0 <span class="m">[ 13.347419] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x44 = 0x0 <span class="m">[ 13.347445] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x48 = 0x0 <span class="m">[ 13.347470] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x49 = 0x0 <span class="m">[ 13.347496] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x4b = 0x0 <span class="m">[ 13.347530] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x4c = 0x0 <span class="m">[ 13.347563] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x4f = 0x0 <span class="m">[ 13.347589] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x46 = 0x0 <span class="m">[ 13.347614] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: led:flash_0: 0x47 = 0x0 <span class="m">[ 13.347622] </span><span class="k">leds_qpnp:</span>qpnp_dump_regs: ===== led:flash_0 LED register dump end ===== </pre></div> <p>Como eu estava confiante que a <em>devicetree</em> agora estava certa, eu voltei para o código do driver. Eu espalhei alguns <code class="docutils literal">pr_debug()</code> pela função de <em>probe</em> e reparei que o valor do <code class="docutils literal">reg</code>, que é lido da <em>devicetree</em> e usado como o endereço de base para todas as operações de leitura e escrita, estava com <code class="docutils literal">0</code>, sendo que ele deveria estar com <code class="docutils literal">0xd300</code>.</p> <p>Ah. Sério?? Bom, não seria uma aventura completa sem eu adicionar meu próprio bug, né? 😝</p> <p>Depois de <a class="reference external" href="https://codeberg.org/nfraprado/linux/commit/bd120825275df7157078992e6b9f29e8216a53b0">consertar o bug</a>, eu recompilei, regravei, reiniciei, retestei eee... UHUU!!!</p> <img alt="Lanterna do Nexus 5 sendo ligada e desligada pela linha de comando" src="/images/qpnp-leds/flash_led.gif" /> <p>Ele não é liiindo? 😍</p> <p>Mas não vamos nos deixar levar por essa luz maravilhosa. Agora que eu finalmente tinha um driver que de fato funcionava, eu rebaseei tudo em cima do ramo principal do kernel original (a essa altura o kernel já tinha avançado do 5.7 para o 5.9) para ter certeza de que tudo continuava funcionando e enviei um <a class="reference external" href="https://lore.kernel.org/linux-arm-msm/20201106165737.1029106-1-nfraprado&#64;protonmail.com/T/">patch RFC</a>!</p> <p>E essa é a lenda de &quot;Como eu portei um driver de LED de flash para o kernel oficial&quot;! Mas calma, esse é o fim desse artigo, mas não é o fim da aventura. Ainda tem muitas coisas que eu preciso fazer para conseguir que essa série de patches adicionando o driver de fato seja incluída no kernel oficial (algumas delas eu ainda vou descobrir pelas respostas do email).</p> <p>Já que meu objetivo aqui era sempre só conseguir fazer funcionar, mudando o mínimo possível, e só depois limpar e deixar ele decente, é isso que eu vou precisar começar a fazer agora 🙂.</p> <p>Só uma última coisa. Esse artigo pode ter feito parecer que a resolução dos problemas foi bem direta, mas muito pelo contrário. Teve vários momentos em que eu não fazia ideia do que fazer, enrolei por várias semanas, e até pensei em desistir e partir para outro projeto.</p> <p>Mas ainda bem que eu sempre continuei tentando e procurando por ajuda, porque por mais que tenha sido muito frustrante às vezes, também foi super divertido e eu aprendi demais. Eu não consigo nem expressar minha felicidade no momento que aquela luz finalmente ligou depois de 4 meses (com pausas) de trabalho.</p> <p>E é isso! Espero estar de volta daqui a alguns meses com um novo artigo contando sobre a minha aventura em transformar um patch RFC em um driver oficial de fato 🙂. Te vejo lá!</p> Edição de arquivos em massa com ranger2020-10-20T00:00:00-03:002020-10-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-10-20:/pt-br/post/edicao-de-arquivos-em-massa-com-ranger.html<p>Meu gerenciador de arquivos é o <a class="reference external" href="https://ranger.github.io/">ranger</a>. Ele é de terminal, permite remapear todos os comandos me permitindo ser mais eficiente em navegar pelos meus arquivos, e é incrivelmente extensível já que permite a criação de comandos customizados em <strong>python</strong>. Se isso não bastasse, ele também tem um monte de …</p><p>Meu gerenciador de arquivos é o <a class="reference external" href="https://ranger.github.io/">ranger</a>. Ele é de terminal, permite remapear todos os comandos me permitindo ser mais eficiente em navegar pelos meus arquivos, e é incrivelmente extensível já que permite a criação de comandos customizados em <strong>python</strong>. Se isso não bastasse, ele também tem um monte de outras funcionalidades (visualização de arquivos extensível, abas, rótulos, ...). Vá checar a <a class="reference external" href="https://github.com/ranger/ranger">página do GitHub</a> deles, sério.</p> <p>Uma funcionalidade muito útil do ranger é o comando <code class="docutils literal">bulkrename</code>. Ele permite que você abra um editor com o nome de todos os arquivos selecionados e os edite. Depois de salvar, um script de shell é gerado para realizar as renomeações necessárias (e te dá a chance de revisá-lo), e como se fosse mágica <em>*puff*</em> você acabou de renomear um monte de arquivos simultaneamente da conveniência do seu editor de texto preferido.</p> <p>Veja um exemplo:</p> <img alt="Comando bulkrename do ranger sendo usado para renomear três arquivos de uma só vez" src="/images/ranger-bulk/bulkrename.gif" /> <p><a class="reference external" href="https://asciinema.org/a/366010">Em asciinema.org</a></p> <p>Bem conveniente. Mas se você parar para pensar, é bem limitado. Por que permitir só renomeação? O mesmo funcionamento poderia ser usado para editar qualquer atributo do arquivo. Só é necessário fornecer uma forma de obter o atributo para cada arquivo selecionado e de gerar um comando de shell que mude o atributo para aplicar a mudança feita pelo usuário.</p> <div class="section" id="o-comando-bulk"> <h2>O comando bulk</h2> <p>Recentemente eu quis modificar o rótulo ID3 <em>Artista</em> de múltiplos arquivos mp3 ao mesmo tempo o que me motivou a escrever a versão genérica do <code class="docutils literal">bulkrename</code> do ranger: <code class="docutils literal">bulk</code>.</p> <p>Para isso eu basicamente copiei o código do <code class="docutils literal">bulkrename</code> e generalizei a obtenção do atributo do arquivo e a geração do comando de modificação do atributo, chamando <code class="docutils literal">get_attribute()</code> e <code class="docutils literal">get_change_attribute_cmd()</code>, respectivamente, de um subcomando bulk armazenado no dicionário <code class="docutils literal">bulk</code>.</p> <p>A classe do comando <code class="docutils literal">bulk</code> é a seguinte:</p> <pre class="code python literal-block"> <span class="k">class</span><span class="w"> </span><span class="nc">bulk</span><span class="p">(</span><span class="n">Command</span><span class="p">):</span><span class="w"> </span><span class="sd">&quot;&quot;&quot;:bulk &lt;attribute&gt; This command opens a list with the attribute &lt;attribute&gt; for each of the selected files in an external editor. After you edit and save the file, it will generate a shell script which changes the attributes in bulk according to the changes you did in the file. This shell script is opened in an editor for you to review. After you close it, it will be executed. &quot;&quot;&quot;</span><span class="w"> </span> <span class="n">bulk</span> <span class="o">=</span> <span class="p">{}</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> <span class="c1"># pylint: disable=too-many-locals,too-many-statements</span><span class="w"> </span> <span class="kn">import</span><span class="w"> </span><span class="nn">sys</span><span class="w"> </span> <span class="kn">import</span><span class="w"> </span><span class="nn">tempfile</span><span class="w"> </span> <span class="kn">from</span><span class="w"> </span><span class="nn">ranger.container.file</span><span class="w"> </span><span class="kn">import</span> <span class="n">File</span><span class="w"> </span> <span class="kn">from</span><span class="w"> </span><span class="nn">ranger.ext.shell_escape</span><span class="w"> </span><span class="kn">import</span> <span class="n">shell_escape</span> <span class="k">as</span> <span class="n">esc</span><span class="w"> </span> <span class="n">py3</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">version_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;=</span> <span class="mi">3</span><span class="w"> </span> <span class="c1"># get bulk command argument</span><span class="w"> </span> <span class="n">bkname</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">rest</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span> <span class="c1"># Create and edit the file list</span><span class="w"> </span> <span class="n">files</span> <span class="o">=</span> <span class="p">[</span><span class="n">f</span> <span class="k">for</span> <span class="n">f</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">fm</span><span class="o">.</span><span class="n">thistab</span><span class="o">.</span><span class="n">get_selection</span><span class="p">()]</span><span class="w"> </span> <span class="n">attributes</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">bulk</span><span class="p">[</span><span class="n">bkname</span><span class="p">]</span><span class="o">.</span><span class="n">get_attribute</span><span class="p">(</span><span class="n">f</span><span class="p">)</span> <span class="k">for</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">files</span><span class="p">]</span><span class="w"> </span> <span class="n">listfile</span> <span class="o">=</span> <span class="n">tempfile</span><span class="o">.</span><span class="n">NamedTemporaryFile</span><span class="p">(</span><span class="n">delete</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span><span class="w"> </span> <span class="n">listpath</span> <span class="o">=</span> <span class="n">listfile</span><span class="o">.</span><span class="n">name</span><span class="w"> </span> <span class="k">if</span> <span class="n">py3</span><span class="p">:</span><span class="w"> </span> <span class="n">listfile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">attributes</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">))</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">listfile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">attributes</span><span class="p">))</span><span class="w"> </span> <span class="n">listfile</span><span class="o">.</span><span class="n">close</span><span class="p">()</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">fm</span><span class="o">.</span><span class="n">execute_file</span><span class="p">([</span><span class="n">File</span><span class="p">(</span><span class="n">listpath</span><span class="p">)],</span> <span class="n">app</span><span class="o">=</span><span class="s1">'editor'</span><span class="p">)</span><span class="w"> </span> <span class="n">listfile</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="n">listpath</span><span class="p">,</span> <span class="s1">'r'</span><span class="p">)</span><span class="w"> </span> <span class="n">new_attributes</span> <span class="o">=</span> <span class="n">listfile</span><span class="o">.</span><span class="n">read</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="n">listfile</span><span class="o">.</span><span class="n">close</span><span class="p">()</span><span class="w"> </span> <span class="n">os</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="n">listpath</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="nb">all</span><span class="p">(</span><span class="n">a</span> <span class="o">==</span> <span class="n">b</span> <span class="k">for</span> <span class="n">a</span><span class="p">,</span> <span class="n">b</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">attributes</span><span class="p">,</span> <span class="n">new_attributes</span><span class="p">)):</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">fm</span><span class="o">.</span><span class="n">notify</span><span class="p">(</span><span class="s2">&quot;Nothing to be done!&quot;</span><span class="p">)</span><span class="w"> </span> <span class="k">return</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="n">new_attributes</span><span class="p">)</span><span class="w"> </span> <span class="c1"># Generate script</span><span class="w"> </span> <span class="n">cmdfile</span> <span class="o">=</span> <span class="n">tempfile</span><span class="o">.</span><span class="n">NamedTemporaryFile</span><span class="p">()</span><span class="w"> </span> <span class="n">script_lines</span> <span class="o">=</span> <span class="p">[]</span><span class="w"> </span> <span class="n">script_lines</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;# This file will be executed when you close the editor.</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="n">script_lines</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;# Please double-check everything, clear the file to abort.</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span><span class="w"> </span> <span class="n">script_lines</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">%s</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">bulk</span><span class="p">[</span><span class="n">bkname</span><span class="p">]</span><span class="o">.</span><span class="n">get_change_attribute_cmd</span><span class="p">(</span><span class="n">file</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">)</span><span class="w"> </span> <span class="k">for</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">,</span> <span class="n">file</span> <span class="ow">in</span><span class="w"> </span> <span class="nb">zip</span><span class="p">(</span><span class="n">attributes</span><span class="p">,</span> <span class="n">new_attributes</span><span class="p">,</span> <span class="n">files</span><span class="p">)</span> <span class="k">if</span> <span class="n">old</span> <span class="o">!=</span> <span class="n">new</span><span class="p">)</span><span class="w"> </span> <span class="n">script_content</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">script_lines</span><span class="p">)</span><span class="w"> </span> <span class="k">if</span> <span class="n">py3</span><span class="p">:</span><span class="w"> </span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">script_content</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">))</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">script_content</span><span class="p">)</span><span class="w"> </span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span><span class="w"> </span> <span class="c1"># Open the script and let the user review it</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">fm</span><span class="o">.</span><span class="n">execute_file</span><span class="p">([</span><span class="n">File</span><span class="p">(</span><span class="n">cmdfile</span><span class="o">.</span><span class="n">name</span><span class="p">)],</span> <span class="n">app</span><span class="o">=</span><span class="s1">'editor'</span><span class="p">)</span><span class="w"> </span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">seek</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span> <span class="c1"># Do the attribute changing</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">fm</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s1">'/bin/sh'</span><span class="p">,</span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">name</span><span class="p">],</span> <span class="n">flags</span><span class="o">=</span><span class="s1">'w'</span><span class="p">)</span><span class="w"> </span> <span class="n">cmdfile</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> </pre> <p>Então, dentro dessa classe, eu adicionei uma classe para cada um dos subcomandos bulk que eu queria adicionar: <code class="docutils literal">id3art</code>, <code class="docutils literal">id3tit</code> e <code class="docutils literal">id3alb</code>, que modificam o rótulo ID3 para o <em>Artista</em>, <em>Título</em> e <em>Álbum</em>, respectivamente.</p> <p>Para cada um deles, eu implementei os métodos <code class="docutils literal">get_attribute()</code> e <code class="docutils literal">get_change_attribute_cmd()</code>. O método <code class="docutils literal">get_attribute()</code> recebe o objeto de arquivo do ranger e deve retornar uma string com o atributo (no caso do <code class="docutils literal">id3art</code>, o rótulo ID3 <em>Artista</em>, o qual foi obtido usando o módulo python <code class="docutils literal">eyed3</code>). O método <code class="docutils literal">get_change_attribute_cmd()</code> recebe o objeto de arquivo do ranger, o atributo antigo (o retornado por <code class="docutils literal">get_attribute()</code>) e o novo (o valor editado pelo usuário), e deve retornar uma string contendo o comando de shell para aplicar a mudança feita pelo usuário (no caso do <code class="docutils literal">id3art</code>, <code class="docutils literal">eyeD3 -a NovoArtista nomeDoArquivo.mp3</code>).</p> <p>Finalmente, eu também adicionei uma entrada para cada um desses subcomandos no dicionário <code class="docutils literal">bulk</code>, que mapeia o nome do subcomando ao seu objeto.</p> <p>Traduzindo tudo isso para código, foi isso o que eu adicionei dentro da classe <code class="docutils literal">bulk</code>:</p> <pre class="code python literal-block"> <span class="k">class</span><span class="w"> </span><span class="nc">id3art</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_attribute</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">):</span><span class="w"> </span> <span class="kn">import</span><span class="w"> </span><span class="nn">eyed3</span><span class="w"> </span> <span class="n">artist</span> <span class="o">=</span> <span class="n">eyed3</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="o">.</span><span class="n">relative_path</span><span class="p">)</span><span class="o">.</span><span class="n">tag</span><span class="o">.</span><span class="n">artist</span><span class="w"> </span> <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">artist</span><span class="p">)</span> <span class="k">if</span> <span class="n">artist</span> <span class="k">else</span> <span class="s1">''</span><span class="w"> </span> <span class="w"> </span> <span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_change_attribute_cmd</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span><span class="w"> </span> <span class="kn">from</span><span class="w"> </span><span class="nn">ranger.ext.shell_escape</span><span class="w"> </span><span class="kn">import</span> <span class="n">shell_escape</span> <span class="k">as</span> <span class="n">esc</span><span class="w"> </span> <span class="k">return</span> <span class="s2">&quot;eyeD3 -a </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">esc</span><span class="p">(</span><span class="n">new</span><span class="p">),</span> <span class="n">esc</span><span class="p">(</span><span class="n">file</span><span class="p">))</span><span class="w"> </span><span class="k">class</span><span class="w"> </span><span class="nc">id3tit</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_attribute</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">):</span><span class="w"> </span> <span class="kn">import</span><span class="w"> </span><span class="nn">eyed3</span><span class="w"> </span> <span class="n">title</span> <span class="o">=</span> <span class="n">eyed3</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="o">.</span><span class="n">relative_path</span><span class="p">)</span><span class="o">.</span><span class="n">tag</span><span class="o">.</span><span class="n">title</span><span class="w"> </span> <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">title</span><span class="p">)</span> <span class="k">if</span> <span class="n">title</span> <span class="k">else</span> <span class="s1">''</span><span class="w"> </span> <span class="w"> </span> <span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_change_attribute_cmd</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span><span class="w"> </span> <span class="kn">from</span><span class="w"> </span><span class="nn">ranger.ext.shell_escape</span><span class="w"> </span><span class="kn">import</span> <span class="n">shell_escape</span> <span class="k">as</span> <span class="n">esc</span><span class="w"> </span> <span class="k">return</span> <span class="s2">&quot;eyeD3 -t </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">esc</span><span class="p">(</span><span class="n">new</span><span class="p">),</span> <span class="n">esc</span><span class="p">(</span><span class="n">file</span><span class="p">))</span><span class="w"> </span><span class="k">class</span><span class="w"> </span><span class="nc">id3alb</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_attribute</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">):</span><span class="w"> </span> <span class="kn">import</span><span class="w"> </span><span class="nn">eyed3</span><span class="w"> </span> <span class="n">album</span> <span class="o">=</span> <span class="n">eyed3</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">file</span><span class="o">.</span><span class="n">relative_path</span><span class="p">)</span><span class="o">.</span><span class="n">tag</span><span class="o">.</span><span class="n">album</span><span class="w"> </span> <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">album</span><span class="p">)</span> <span class="k">if</span> <span class="n">album</span> <span class="k">else</span> <span class="s1">''</span><span class="w"> </span> <span class="w"> </span> <span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">get_change_attribute_cmd</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">file</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span><span class="w"> </span> <span class="kn">from</span><span class="w"> </span><span class="nn">ranger.ext.shell_escape</span><span class="w"> </span><span class="kn">import</span> <span class="n">shell_escape</span> <span class="k">as</span> <span class="n">esc</span><span class="w"> </span> <span class="k">return</span> <span class="s2">&quot;eyeD3 -A </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">esc</span><span class="p">(</span><span class="n">new</span><span class="p">),</span> <span class="n">esc</span><span class="p">(</span><span class="n">file</span><span class="p">))</span><span class="w"> </span><span class="n">bulk</span> <span class="o">=</span> <span class="p">{</span><span class="s1">'id3art'</span><span class="p">:</span> <span class="n">id3art</span><span class="p">(),</span><span class="w"> </span> <span class="s1">'id3tit'</span><span class="p">:</span> <span class="n">id3tit</span><span class="p">(),</span><span class="w"> </span> <span class="s1">'id3alb'</span><span class="p">:</span> <span class="n">id3alb</span><span class="p">(),</span><span class="w"> </span> <span class="p">}</span> </pre> <p>E aqui está ele em ação:</p> <img alt="O subcomando bulk id3art sendo usado para mudar o rótulo ID3 Artista de três arquivos mp3 de uma vez só" src="/images/ranger-bulk/bulk.gif" /> <p><a class="reference external" href="https://asciinema.org/a/366013">Em asciinema.org</a></p> <p>Já que eu percebi que esse funcionamento genérico do comando bulk poderia ser útil para todos os usuários do ranger, cada um implementando seu próprio subcomando bulk, eu <a class="reference external" href="https://github.com/ranger/ranger/pull/2109">sugeri a adição da funcionalidade</a>. Aparentemente a ideia foi bem aceita, e inclusive há a intenção de tornar o <code class="docutils literal">bulkrename</code> apenas um apelido para um subcomando bulk, então talvez em um futuro próximo você possa criar seu próprio subcomando bulk usando o comando <code class="docutils literal">bulk</code> já integrado ao ranger 🙂.</p> </div> Geração de listas de reprodução de música com o MPD2020-09-20T00:00:00-03:002020-09-20T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-09-20:/pt-br/post/geracao-de-listas-de-reproducao-de-musica-com-o-mpd.html<p>Música é vida. Eu realmente amo ouvir música, apesar que não o mesmo tipo de música o tempo todo. Mas na maioria das vezes, vai de tudo: Eu gosto de ouvir qualquer uma das músicas que eu tenho aleatoriamente. Mas quando eu estou fazendo algo que precisa de concentração (como …</p><p>Música é vida. Eu realmente amo ouvir música, apesar que não o mesmo tipo de música o tempo todo. Mas na maioria das vezes, vai de tudo: Eu gosto de ouvir qualquer uma das músicas que eu tenho aleatoriamente. Mas quando eu estou fazendo algo que precisa de concentração (como escrever esse texto) eu só posso ouvir música &quot;de fundo&quot;, ou seja, música que não tem vocal. Por isso ter agrupamentos de músicas é bem útil para esse tipo de situação.</p> <p>Um jeito de agrupar músicas é por meio de listas de reprodução. Mas os critérios que determinam quais músicas vão em uma lista é bastante subjetivo já que é determinado por mim, um ser humano. Foi isso que me motivou a criar algum jeito de gerar listas de reprodução baseado em critérios variados: nome de pasta, artista, álbum, etc.</p> <p>Recentemente eu li o incrível livro <a class="reference external" href="https://www.amazon.com.br/Python-Fluente-Programa%C3%A7%C3%A3o-Concisa-Eficaz/dp/857522462X">Python Fluente</a> (de autor brasileiro!) com o objetivo de aprofundar minhas habilidades em python, que se tornou minha linguagem de programação preferida já há algum tempo. Eu aprendi bastante lendo esse livro, mas ainda não tinha praticado nada do que aprendi. Uma das coisas mais interessantes que aprendi foi sobre os <a class="reference external" href="https://docs.python.org/3/reference/datamodel.html#special-method-names">métodos especiais</a> que fazem dos objetos em python tão flexíveis. Foi aí que percebi que usando métodos especiais, eu conseguiria criar objetos de lista de reprodução bem flexíveis e ao mesmo tempo praticar esse conceito mágico. Ganha-ganha.</p> <p>O programa que eu uso para gerenciar minha biblioteca de músicas e também para tocar as músicas é o <a class="reference external" href="https://www.musicpd.org/">MPD</a>. Ele suporta requisição de informações sobre as músicas por outros programas e também reproduzir músicas com base em uma lista de reprodução, então foi simples fazer o código de geração de listas de reprodução usando o MPD.</p> <div class="section" id="a-classe-mpdplaylist"> <h2>A classe MPDPlaylist</h2> <p>A ideia é a seguinte: Eu quero poder criar uma lista de reprodução especificando o que ela deve conter, e também o que ela não deve, e também poder combinar critérios de outras listas usando operações de E e OU. Isso provavelmente ficará mais claro mais à frente com os exemplos.</p> <p>O código que implementa essa classe está em <code class="docutils literal">mpd_playlist.py</code>, e contém o seguinte:</p> <pre class="code python literal-block"> <span class="kn">from</span><span class="w"> </span><span class="nn">mpd</span><span class="w"> </span><span class="kn">import</span> <span class="n">MPDClient</span><span class="w"> </span><span class="n">client</span> <span class="o">=</span> <span class="n">MPDClient</span><span class="p">()</span><span class="w"> </span><span class="n">client</span><span class="o">.</span><span class="n">timeout</span> <span class="o">=</span> <span class="mi">60</span><span class="w"> </span><span class="n">client</span><span class="o">.</span><span class="n">idletimeout</span> <span class="o">=</span> <span class="kc">None</span><span class="w"> </span><span class="n">client</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s2">&quot;localhost&quot;</span><span class="p">,</span> <span class="mi">6600</span><span class="p">)</span><span class="w"> </span><span class="k">class</span><span class="w"> </span><span class="nc">MPDPlaylist</span><span class="p">():</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">''</span><span class="p">):</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span><span class="w"> </span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="p">):</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">songs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">query</span><span class="o">.</span><span class="n">songs</span><span class="p">)</span><span class="w"> </span> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query</span><span class="p">,</span> <span class="nb">set</span><span class="p">):</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">songs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">query</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="bp">self</span><span class="o">.</span><span class="n">songs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">query_songs</span><span class="p">(</span><span class="n">query</span><span class="p">)</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span><span class="w"> </span> <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">, </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">songs</span><span class="si">}</span><span class="s2">)&quot;</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="fm">__or__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span><span class="w"> </span> <span class="k">return</span> <span class="n">MPDPlaylist</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">songs</span><span class="o">.</span><span class="n">union</span><span class="p">(</span><span class="n">other</span><span class="o">.</span><span class="n">songs</span><span class="p">))</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="fm">__and__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">):</span><span class="w"> </span> <span class="k">return</span> <span class="n">MPDPlaylist</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">songs</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">other</span><span class="o">.</span><span class="n">songs</span><span class="p">))</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="fm">__neg__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span><span class="w"> </span> <span class="k">return</span> <span class="n">MPDPlaylist</span><span class="p">(</span><span class="n">MPDPlaylist</span><span class="p">({})</span><span class="o">.</span><span class="n">songs</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">songs</span><span class="p">))</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">query_songs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">queries</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="n">queries</span><span class="p">:</span><span class="w"> </span> <span class="n">args</span> <span class="o">=</span> <span class="p">[]</span><span class="w"> </span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span><span class="n">v</span> <span class="ow">in</span> <span class="n">queries</span><span class="o">.</span><span class="n">items</span><span class="p">():</span><span class="w"> </span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">k</span><span class="p">)</span><span class="w"> </span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="w"> </span> <span class="k">return</span> <span class="nb">set</span><span class="p">(</span><span class="n">song</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">'file'</span><span class="p">)</span> <span class="k">for</span> <span class="n">song</span> <span class="ow">in</span> <span class="n">client</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">))</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="k">return</span> <span class="nb">set</span><span class="p">(</span><span class="n">song</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">'file'</span><span class="p">)</span> <span class="k">for</span> <span class="n">song</span> <span class="ow">in</span> <span class="n">client</span><span class="o">.</span><span class="n">listall</span><span class="p">()</span> <span class="k">if</span><span class="w"> </span> <span class="n">song</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">'file'</span><span class="p">))</span><span class="w"> </span> <span class="k">def</span><span class="w"> </span><span class="nf">write_to_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">base</span><span class="p">):</span><span class="w"> </span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">:</span><span class="w"> </span> <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">base</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">.m3u&quot;</span><span class="p">,</span> <span class="s1">'w'</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span><span class="w"> </span> <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="s1">'</span><span class="se">\n</span><span class="s1">'</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">songs</span><span class="p">)</span> <span class="o">+</span> <span class="s1">'</span><span class="se">\n</span><span class="s1">'</span><span class="p">)</span><span class="w"> </span> <span class="k">else</span><span class="p">:</span><span class="w"> </span> <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Can't write playlist with no name!&quot;</span><span class="p">)</span> </pre> <p>Aquele trecho com <code class="docutils literal">MPDClient()</code> no começo é necessário para conectar ao banco de dados do MPD para posteriormente obter todas as informações sobre as músicas. Ele é provido pelo pacote <a class="reference external" href="https://github.com/Mic92/python-mpd2">python-mpd2</a>.</p> <p>O método <code class="docutils literal">__init__()</code>, que é chamado quando um novo objeto é criado, pode receber outra lista de reprodução como seu parâmetro <code class="docutils literal">query</code> e nesse caso a nova lista apenas as músicas da lista passada. Ele também pode receber um conjunto de músicas (o que eu ainda nem cheguei a usar, mas fazia sentido suportar). E finalmente, no caso mais comum, pode receber um dicionário contendo os parâmetros de busca que vão ser usados para filtrar as músicas do MPD. Para todos os casos, um nome pode opcionalmente ser passado (necessário para que a lista possa ser salva).</p> <p>Então, por exemplo, <code class="docutils literal">músicas_paramore = MPDPlaylist({'artist': 'Paramore'})</code> criaria uma lista de reprodução apenas com músicas do Paramore, e <code class="docutils literal">músicas_paramore2 = MPDPlaylist(músicas_paramore)</code> poderia ser usado para criar uma cópia dessa lista. Esse segundo caso não parece tão útil mas é a base para processar expressões, como veremos.</p> <p><code class="docutils literal">__repr__()</code> só é usado para depurar. Ele especifica como o objeto é escrito na tela, nesse caso, mostrando quais músicas a lista de reprodução contém.</p> <p><code class="docutils literal">__or__()</code> e <code class="docutils literal">__and__()</code> são chamadas quando duas listas de reprodução são combinadas com OU (usando <code class="docutils literal">|</code>) e com E (usando <code class="docutils literal">&amp;</code>), retornando uma lista que contém a união (músicas das duas listas) e a intersecção (apenas músicas presentes nas duas) respectivamente. <code class="docutils literal">__neg__()</code> serve para negar a lista (usando <code class="docutils literal">-</code>), fazendo com que os parâmetros de busca especifiquem o que ela <strong>não</strong> deve conter, e portanto que ela contenha tudo menos o que for indicado.</p> <p><code class="docutils literal">query_songs()</code> obtém as músicas do MPD com base nos parâmetros de busca e as salva dentro do objeto.</p> <p><code class="docutils literal">write_to_file()</code> salva a lista de reprodução em um arquivo <code class="docutils literal">.m3u</code> para que possa posteriormente ser lido e as músicas reproduzidas pelo MPD. O nome do arquivo é o que foi fornecido em <code class="docutils literal">__init__</code>.</p> <p>Agora, alguns exemplos.</p> </div> <div class="section" id="minhas-listas-de-reproducao"> <h2>Minhas listas de reprodução</h2> <p>Em outro arquivo, <code class="docutils literal">playlists.py</code>, eu tenho a definição de todas as minhas listas de reprodução usando a classe MPDPlaylist:</p> <pre class="code python literal-block"> <span class="kn">from</span><span class="w"> </span><span class="nn">mpd_playlist</span><span class="w"> </span><span class="kn">import</span> <span class="n">MPDPlaylist</span> <span class="k">as</span> <span class="n">PL</span><span class="w"> </span><span class="n">saved</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres&quot;</span><span class="p">},</span> <span class="s2">&quot;0_Saved&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">buffer</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;buffer&quot;</span><span class="p">},</span> <span class="s2">&quot;1_Buffer&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">fvt</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'file'</span><span class="p">:</span> <span class="s2">&quot;/%&quot;</span><span class="p">},</span> <span class="s2">&quot;1_FvtAlbums&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">br</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/br&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Br&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">classical</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/classical&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Classical&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">electronic</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/electronic&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Electronic&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">etc</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/etc&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_ETC&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">instrumental</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/instrumental&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Instrumental&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">jazz</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/jazz&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Jazz&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">pop</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/pop&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Pop&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">post_rock</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/post-rock&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Post-rock&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">rap</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/rap&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Rap&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">rock</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/rock&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Rock&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">soundtrack</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack&quot;</span><span class="p">}</span> <span class="p">,</span> <span class="s2">&quot;2_Sountrack&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">common</span> <span class="o">=</span> <span class="n">PL</span><span class="p">(</span><span class="n">rock</span> <span class="o">|</span> <span class="n">electronic</span> <span class="o">|</span> <span class="n">pop</span> <span class="o">|</span> <span class="n">post_rock</span> <span class="o">|</span> <span class="n">rap</span><span class="p">,</span> <span class="s2">&quot;1_Common&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">not_soundtrack</span> <span class="o">=</span> <span class="n">PL</span><span class="p">(</span><span class="o">-</span><span class="n">soundtrack</span><span class="p">,</span> <span class="s2">&quot;2_NotSoundtrack&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">tdg</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'artist'</span><span class="p">:</span> <span class="s2">&quot;Three Days Grace&quot;</span><span class="p">},</span> <span class="s2">&quot;3_TDG&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">minecraft</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/games/%minecraft&quot;</span><span class="p">},</span> <span class="s2">&quot;3_Minecraft&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">lotr</span> <span class="o">=</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/movies/lotr&quot;</span><span class="p">},</span> <span class="s2">&quot;3_LOTR&quot;</span><span class="p">)</span><span class="w"> </span><span class="n">background</span> <span class="o">=</span> <span class="n">PL</span><span class="p">(</span><span class="n">classical</span><span class="w"> </span> <span class="o">|</span> <span class="n">jazz</span><span class="w"> </span> <span class="o">|</span> <span class="n">instrumental</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'artist'</span><span class="p">:</span> <span class="s2">&quot;Balmorhea&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'artist'</span><span class="p">:</span> <span class="s2">&quot;Tycho&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'artist'</span><span class="p">:</span> <span class="s2">&quot;MASTER BOOT RECORD&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'artist'</span><span class="p">:</span> <span class="s2">&quot;The Album Leaf&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/animes/tatami_galaxy/</span><span class="si">%o</span><span class="s2">st&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">|</span> <span class="n">PL</span><span class="p">({</span><span class="s1">'base'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/games&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">&amp;</span> <span class="o">-</span><span class="n">PL</span><span class="p">({</span><span class="s1">'file'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/games/Portal - Still Alive.mp3&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">&amp;</span> <span class="o">-</span><span class="n">PL</span><span class="p">({</span><span class="s1">'file'</span><span class="p">:</span> <span class="s2">&quot;genres/soundtrack/games/portal_2/3-13_want_you_gone.mp3&quot;</span><span class="p">})</span><span class="w"> </span> <span class="o">&amp;</span> <span class="o">-</span><span class="n">PL</span><span class="p">({</span><span class="s1">'title'</span><span class="p">:</span> <span class="s2">&quot;Here Comes Vi&quot;</span><span class="p">}),</span><span class="w"> </span> <span class="s2">&quot;1_Background&quot;</span><span class="p">)</span> </pre> <p>As primeiras listas criadas são:</p> <ul class="simple"> <li><code class="docutils literal">saved</code>, que contém todas as músicas da pasta <code class="docutils literal">genres</code>, essencialmente minha biblioteca de músicas;</li> <li><code class="docutils literal">buffer</code>, com todas as músicas da pasta <code class="docutils literal">buffer</code>, que são aquelas que ainda estou ouvindo para decidir se gosto ou não;</li> <li><code class="docutils literal">fvt</code> com todas as músicas de pastas começando com <code class="docutils literal">%</code>, que são meus álbuns favoritos</li> </ul> <p>Em seguida são definidas listas pra cada um dos gêneros. Algumas delas, <code class="docutils literal">rock</code>, <code class="docutils literal">electronic</code>, <code class="docutils literal">pop</code>, <code class="docutils literal">post_rock</code> e <code class="docutils literal">rap</code> são então combinadas usando o operador OU (<code class="docutils literal">|</code>) para criar a lista <code class="docutils literal">common</code>. Isso significa que essa lista de reprodução contém as músicas de todas essas listas combinadas.</p> <p>Aí a lista <code class="docutils literal">not_soundtrack</code> é criada negando a lista <code class="docutils literal">soundtrack</code>, então aquela contém apenas as músicas não presentes nesta.</p> <p>A lista <code class="docutils literal">tdg</code> possui apenas músicas do artista <code class="docutils literal">Three Days Grace</code>.</p> <p>A última lista, <code class="docutils literal">background</code>, combina várias listas definidas anteriormente como <code class="docutils literal">classical</code>, e também listas anônimas como <code class="docutils literal">PL({'artist': &quot;Balmorhea&quot;})</code> (que são usadas apenas para criar essa lista, e não serão salvas como listas independentes, portanto não são armazenadas em variáveis e também não precisam de um nome como parâmetro), bem como remove músicas específicas como <code class="docutils literal">PL({'file': &quot;genres/soundtrack/games/Portal - Still Alive.mp3&quot;})</code>.</p> <p>Não é a sintaxe mais sucinta de todas, mas também não chega a ser extensa e é bastante flexível: serviu para tudo que eu precisava customizando as minhas listas.</p> </div> <div class="section" id="salvando-as-listas-de-reproducao"> <h2>Salvando as listas de reprodução</h2> <p>Talvez agora você esteja se perguntando como essas listas de reprodução são escritas em arquivos se elas são apenas criadas e armazenadas em variáveis. A resposta é: python é demais 😃. Esse é <code class="docutils literal">gen_playlists.py</code>, o código que faz isso:</p> <pre class="code python literal-block"> <span class="ch">#!/bin/python</span><span class="w"> </span><span class="kn">from</span><span class="w"> </span><span class="nn">os.path</span><span class="w"> </span><span class="kn">import</span> <span class="n">expanduser</span><span class="w"> </span><span class="kn">from</span><span class="w"> </span><span class="nn">mpd_playlist</span><span class="w"> </span><span class="kn">import</span> <span class="n">MPDPlaylist</span><span class="w"> </span><span class="kn">import</span><span class="w"> </span><span class="nn">playlists</span><span class="w"> </span><span class="n">PLD</span> <span class="o">=</span> <span class="n">expanduser</span><span class="p">(</span><span class="s2">&quot;~/.config/mpd/playlists&quot;</span><span class="p">)</span><span class="w"> </span><span class="c1"># All variables defined locally with type MPDPlaylist and with a name will be</span><span class="w"> </span><span class="c1"># contained here</span><span class="w"> </span><span class="n">playlists</span> <span class="o">=</span> <span class="p">(</span><span class="n">pl</span> <span class="k">for</span> <span class="n">pl</span> <span class="ow">in</span> <span class="nb">vars</span><span class="p">(</span><span class="n">playlists</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">()</span><span class="w"> </span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">pl</span><span class="p">,</span> <span class="n">MPDPlaylist</span><span class="p">)</span> <span class="ow">and</span> <span class="n">pl</span><span class="o">.</span><span class="n">name</span><span class="p">)</span><span class="w"> </span><span class="k">for</span> <span class="n">playlist</span> <span class="ow">in</span> <span class="n">playlists</span><span class="p">:</span><span class="w"> </span> <span class="n">playlist</span><span class="o">.</span><span class="n">write_to_file</span><span class="p">(</span><span class="n">PLD</span><span class="p">)</span> </pre> <p>Como aquele comentário gentil em cima diz, <code class="docutils literal">playlists = (pl for pl in vars(playlists).values() if isinstance(pl, MPDPlaylist) and pl.name)</code> obtém todas as variáveis do tipo <code class="docutils literal">MPDPlaylist</code> de <code class="docutils literal">playlists.py</code>, desde que tenham nome. Aí laço <code class="docutils literal">for</code> itera sobre elas e salva cada uma em um arquivo com seu nome.</p> <p>Por fim, eu adicionei uma linha no <code class="docutils literal">cron</code> para executar esse script todo domingo, atualizando minhas listas de reprodução.</p> </div> <div class="section" id="a-lista-de-reproducao-newest"> <h2>A lista de reprodução 'newest'</h2> <p>Como nada é perfeito, tem uma lista de reprodução que eu não consegui integrar nessa infraestrutura e portanto ficou como um script em bash separado 🤢: a lista <code class="docutils literal">newest</code>. Ela contém as últimas 100 músicas adicionadas à minha biblioteca.</p> <p>Existem quatro tipos de datas em arquivos de acordo com o <code class="docutils literal">stat</code>:</p> <ul class="simple"> <li>data de criação do arquivo</li> <li>data do último acesso</li> <li>data da última modificação</li> <li>data da última mudança de estado</li> </ul> <p>Para obter as últimas músicas adicionadas, e não as últimas editadas (às vezes eu edito os metadados de uma música, e não quero que isso interfira nessa lista), eu precisava usar a data de criação, mas ela não é suportada pelo MPD, então é por isso que estou fadado a usar esse script, <code class="docutils literal">gen_playlist_newest.sh</code>:</p> <pre class="code shell literal-block"> <span class="nv">PLD</span><span class="o">=</span><span class="nv">$HOME</span>/.config/mpd/playlists<span class="w"> </span>find<span class="w"> </span>~/ark/mus/genres<span class="w"> </span>-type<span class="w"> </span>f<span class="w"> </span>-regextype<span class="w"> </span>posix-extended<span class="w"> </span>-regex<span class="w"> </span><span class="s1">'.*\.(flac|mp3)'</span><span class="w"> </span>-exec<span class="w"> </span>stat<span class="w"> </span>--format<span class="w"> </span><span class="s1">'%W : %n'</span><span class="w"> </span><span class="s2">&quot;{}&quot;</span><span class="w"> </span><span class="se">\;</span><span class="w"> </span><span class="se">\ </span><span class="w"> </span><span class="p">|</span><span class="w"> </span>sort<span class="w"> </span>-nr<span class="w"> </span><span class="p">|</span><span class="w"> </span>head<span class="w"> </span>-n<span class="w"> </span><span class="m">100</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>cut<span class="w"> </span>-d:<span class="w"> </span>-f2<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span>-e<span class="w"> </span><span class="s1">'s|.*mus/\(.*\)|\1|'</span><span class="w"> </span>&gt;<span class="w"> </span><span class="se">\ </span><span class="w"> </span><span class="nv">$PLD</span>/1_Newest.m3u </pre> </div> Detecção de contexto automática para o Taskwarrior2020-08-24T00:00:00-03:002020-08-24T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-08-24:/pt-br/post/deteccao-de-contexto-automatica-para-o-taskwarrior.html<p>Uma das principais ideias do <a class="reference external" href="https://en.wikipedia.org/wiki/Getting_Things_Done">GTD</a> é a associação de contexto à cada tarefa para que seja muito fácil ver quais tarefas podem ser feitas no contexto atual. Eu organizo minhas tarefas com o <a class="reference external" href="https://taskwarrior.org/">Taskwarrior</a>, então para utilizar contextos com ele, quando eu adiciono uma nova tarefa eu preciso vinculá-la …</p><p>Uma das principais ideias do <a class="reference external" href="https://en.wikipedia.org/wiki/Getting_Things_Done">GTD</a> é a associação de contexto à cada tarefa para que seja muito fácil ver quais tarefas podem ser feitas no contexto atual. Eu organizo minhas tarefas com o <a class="reference external" href="https://taskwarrior.org/">Taskwarrior</a>, então para utilizar contextos com ele, quando eu adiciono uma nova tarefa eu preciso vinculá-la a um contexto e também atualizar o contexto sempre que ele mudar. Há diferentes tipos de contexto, mas os mais fáceis de automatizar são os espaciais, ou seja, quais tarefas eu posso fazer <strong>onde</strong> eu estou nesse momento.</p> <p>Para vincular uma tarefa a um contexto basta adicionar um rótulo a ela. Como eu normalmente estou em um de três lugares, eu adiciono o rótulo <code class="docutils literal">&#64;rep</code>, <code class="docutils literal">&#64;sp</code> ou <code class="docutils literal">&#64;uni</code> dependendo de onde a tarefa pode ser feita.</p> <p>Já para atualizar o contexto atual eu precisaria indicar manualmente para o Taskwarrior onde eu estou no momento toda vez que eu for para um outro lugar. Por exemplo, eu precisaria digitar <code class="docutils literal">task context uni</code> toda vez que eu fosse para a universidade. Isso além de ser bem chato é uma fonte de erros: já aconteceu mais de uma vez de eu levar alguns segundos até entender porque algumas tarefas estavam faltando.</p> <p>Mas como todo pequeno problema na vida, isso pode ser solucionado com um pequeno script. E é por isso que eu escrevi um script em python para detectar e configurar automaticamente o contexto atual do Taskwarrior.</p> <div class="section" id="script-em-python"> <h2>Script em python</h2> <p>A ideia é bem simples: eu quase sempre estou conectado a uma rede sem fio, já que essa conexão é automática, e cada local tem um nome específico para a rede, então eu só preciso obter o SSID da rede atual e configurar o contexto correspondente.</p> <p>É isso que o seguinte programa em python faz (além de mandar uma notificação usando <code class="docutils literal">notify-send</code>):</p> <div class="highlight"><pre><span></span><span class="kn">import</span><span class="w"> </span><span class="nn">subprocess</span> <span class="n">contexts</span> <span class="o">=</span> <span class="p">{</span> <span class="s1">&#39;rep&#39;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;rep wifi 1&quot;</span><span class="p">,</span> <span class="s2">&quot;rep wifi 2&quot;</span><span class="p">,</span> <span class="s2">&quot;rep wifi 3&quot;</span><span class="p">],</span> <span class="s1">&#39;sp&#39;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;sp wifi 1&quot;</span><span class="p">,</span> <span class="s2">&quot;sp wifi 2&quot;</span><span class="p">],</span> <span class="s1">&#39;uni&#39;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;eduroam&quot;</span><span class="p">]</span> <span class="p">}</span> <span class="k">def</span><span class="w"> </span><span class="nf">get_context</span><span class="p">(</span><span class="n">wifi</span><span class="p">):</span> <span class="k">for</span> <span class="n">context</span> <span class="ow">in</span> <span class="n">contexts</span><span class="p">:</span> <span class="k">if</span> <span class="n">wifi</span> <span class="ow">in</span> <span class="n">contexts</span><span class="p">[</span><span class="n">context</span><span class="p">]:</span> <span class="k">return</span> <span class="n">context</span> <span class="k">return</span> <span class="kc">None</span> <span class="k">def</span><span class="w"> </span><span class="nf">get_current_context</span><span class="p">():</span> <span class="n">wifi_cmd</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s2">&quot;iwgetid&quot;</span><span class="p">,</span> <span class="s2">&quot;-r&quot;</span><span class="p">],</span> <span class="n">text</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">capture_output</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> <span class="n">wifi</span> <span class="o">=</span> <span class="n">wifi_cmd</span><span class="o">.</span><span class="n">stdout</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="k">return</span> <span class="n">get_context</span><span class="p">(</span><span class="n">wifi</span><span class="p">)</span> <span class="k">def</span><span class="w"> </span><span class="nf">set_current_context</span><span class="p">():</span> <span class="n">context</span> <span class="o">=</span> <span class="n">get_current_context</span><span class="p">()</span> <span class="k">if</span> <span class="n">context</span><span class="p">:</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s2">&quot;notify-send&quot;</span><span class="p">,</span> <span class="s2">&quot;Taskwarrior context&quot;</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;Setting context to &lt;b&gt;</span><span class="si">{</span><span class="n">context</span><span class="si">}</span><span class="s2">&lt;/b&gt;&quot;</span><span class="p">])</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s2">&quot;task&quot;</span><span class="p">,</span> <span class="s2">&quot;context&quot;</span><span class="p">,</span> <span class="n">context</span><span class="p">])</span> <span class="k">else</span><span class="p">:</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s2">&quot;notify-send&quot;</span><span class="p">,</span> <span class="s2">&quot;-u&quot;</span><span class="p">,</span> <span class="s2">&quot;critical&quot;</span><span class="p">,</span> <span class="s2">&quot;Taskwarrior context&quot;</span><span class="p">,</span> <span class="s2">&quot;Failure to detect context&quot;</span><span class="p">])</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">run</span><span class="p">([</span><span class="s2">&quot;task&quot;</span><span class="p">,</span> <span class="s2">&quot;context&quot;</span><span class="p">,</span> <span class="s2">&quot;none&quot;</span><span class="p">])</span> </pre></div> <p><strong>Obs</strong>: Os nomes das redes dos contextos <code class="docutils literal">rep</code> e <code class="docutils literal">sp</code> foram censurados para evitar exposição.</p> </div> <div class="section" id="servico-do-systemd"> <h2>Serviço do systemd</h2> <p>Já que quando eu vou de um lugar para o outro eu sempre suspendo, hiberno ou desligo meu computador, esse programa só precisa executar depois de resumir ou ligar o computador, e é exatamente para isso que serve o seguinte serviço do systemd:</p> <div class="highlight"><pre><span></span><span class="k">[Unit]</span> <span class="na">Description</span><span class="o">=</span><span class="s">Set taskwarrior context</span> <span class="na">Wants</span><span class="o">=</span><span class="s">network-online.target NetworkManager-wait-online.service</span> <span class="na">After</span><span class="o">=</span><span class="s">network-online.target NetworkManager-wait-online.service hibernate.target suspend.target</span> <span class="k">[Service]</span> <span class="na">User</span><span class="o">=</span><span class="s">%I</span> <span class="na">Type</span><span class="o">=</span><span class="s">oneshot</span> <span class="na">Environment</span><span class="o">=</span><span class="s">PATH=/usr/bin:/home/nfraprado/ark/code/.path/</span> <span class="na">Environment</span><span class="o">=</span><span class="s">DISPLAY=:0</span> <span class="na">Environment</span><span class="o">=</span><span class="s">XAUTHORITY=%h/.Xauthority</span> <span class="na">Environment</span><span class="o">=</span><span class="s">DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus</span> <span class="na">ExecStartPre</span><span class="o">=</span><span class="s">/usr/bin/sleep 30</span> <span class="na">ExecStart</span><span class="o">=</span><span class="s">/home/nfraprado/ark/code/.path/taskwarrior-update_context</span> <span class="na">ExecStartPost</span><span class="o">=</span> <span class="k">[Install]</span> <span class="na">WantedBy</span><span class="o">=</span><span class="s">multi-user.target</span> <span class="na">WantedBy</span><span class="o">=</span><span class="s">hibernate.target</span> <span class="na">WantedBy</span><span class="o">=</span><span class="s">suspend.target</span> </pre></div> <p>Detalhes sobre esse arquivo de serviço:</p> <ul class="simple"> <li>Os serviços <code class="docutils literal">network-online</code> e <code class="docutils literal">wait-online</code> supostamente fazem com que ele espere o NetworkManager conectar a uma rede antes de executar, mas pelos meus testes isso não foi o suficiente e portanto eu acabei adicionando 30 segundos de atraso como pode ser visto em <code class="docutils literal">ExecStartPre</code>.</li> <li>Os alvos <code class="docutils literal">hibernate</code> e <code class="docutils literal">suspend</code> fazem com que ele rode depois do computador resumir ou ligar.</li> <li>As variáveis de ambiente <code class="docutils literal">DISPLAY</code>, <code class="docutils literal">XAUTHORITY</code> e <code class="docutils literal">DBUS_SESSION_BUS_ADDRESS</code> permitem que a notificação apareça.</li> <li><code class="docutils literal">taskwarrior-update_context</code> basicamente chama <code class="docutils literal">set_current_context()</code> do script em python.</li> </ul> <p>E é isso! Com esses dois componentes, depois que eu vou de um lugar para o outro e abro meu computador, o contexto do Taskwarrior é automaticamente atualizado, me mostrando só as tarefas relevantes para o lugar que estou atualmente.</p> </div> <div class="section" id="extra-script-anterior"> <h2>Extra: Script anterior</h2> <p>Uma pequena tangente: antes daquele script em python, eu tinha feito um em bash. Apesar de executar comandos no bash ser mais limpo do que o <code class="docutils literal">subprocess.run()</code> do python, eu acho a sintaxe do bash horrível. Eu também acho ridículo precisar definir uma função <code class="docutils literal">array_contains</code> (que eu copiei de alguma resposta do StackOverflow). Enfim, esse era o script em bash caso esteja com curiosidade:</p> <div class="highlight"><pre><span></span><span class="ch">#!/bin/bash</span> <span class="nv">wifi</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>iwgetid<span class="w"> </span>-r<span class="k">)</span><span class="s2">&quot;</span> <span class="nb">declare</span><span class="w"> </span>-a<span class="w"> </span><span class="nv">rep</span><span class="o">=(</span><span class="s2">&quot;rep wifi 1&quot;</span><span class="w"> </span><span class="s2">&quot;rep wifi 2&quot;</span><span class="w"> </span><span class="s2">&quot;rep wifi 3&quot;</span><span class="o">)</span> <span class="nb">declare</span><span class="w"> </span>-a<span class="w"> </span><span class="nv">sp</span><span class="o">=(</span><span class="s2">&quot;sp wifi 1&quot;</span><span class="w"> </span><span class="s2">&quot;sp wifi 2&quot;</span><span class="o">)</span> <span class="nb">declare</span><span class="w"> </span>-a<span class="w"> </span><span class="nv">uni</span><span class="o">=(</span><span class="s2">&quot;eduroam&quot;</span><span class="o">)</span> array_contains<span class="w"> </span><span class="o">()</span><span class="w"> </span><span class="o">{</span> <span class="w"> </span><span class="nb">local</span><span class="w"> </span><span class="nv">array</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$1</span><span class="s2">[@]&quot;</span> <span class="w"> </span><span class="nb">local</span><span class="w"> </span><span class="nv">seeking</span><span class="o">=</span><span class="nv">$2</span> <span class="w"> </span><span class="nb">local</span><span class="w"> </span><span class="k">in</span><span class="o">=</span><span class="m">1</span> <span class="w"> </span><span class="k">for</span><span class="w"> </span>element<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="p">!array</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span><span class="k">do</span> <span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="o">[[</span><span class="w"> </span><span class="nv">$element</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nv">$seeking</span><span class="w"> </span><span class="o">]]</span><span class="p">;</span><span class="w"> </span><span class="k">then</span> <span class="w"> </span><span class="k">in</span><span class="o">=</span><span class="m">0</span> <span class="w"> </span><span class="k">break</span> <span class="w"> </span><span class="k">fi</span> <span class="w"> </span><span class="k">done</span> <span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nv">$in</span> <span class="o">}</span> array_contains<span class="w"> </span>rep<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$wifi</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nv">context</span><span class="o">=</span>rep array_contains<span class="w"> </span>sp<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$wifi</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nv">context</span><span class="o">=</span>sp array_contains<span class="w"> </span>uni<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$wifi</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nv">context</span><span class="o">=</span>uni <span class="k">if</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>-z<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$context</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">]</span><span class="p">;</span><span class="k">then</span> <span class="w"> </span>notify-send<span class="w"> </span>-u<span class="w"> </span>critical<span class="w"> </span><span class="s2">&quot;Taskwarrior context&quot;</span><span class="w"> </span><span class="s2">&quot;Failure to detect context&quot;</span> <span class="w"> </span>task<span class="w"> </span>context<span class="w"> </span>none<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span> <span class="k">else</span> <span class="w"> </span>notify-send<span class="w"> </span><span class="s2">&quot;Taskwarrior context&quot;</span><span class="w"> </span><span class="s2">&quot;Setting context to &lt;b&gt;</span><span class="nv">$context</span><span class="s2">&lt;/b&gt;&quot;</span> <span class="w"> </span>task<span class="w"> </span>context<span class="w"> </span><span class="nv">$context</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span> <span class="k">fi</span> </pre></div> </div> Configurando o mbsync para usar XOAUTH22020-07-30T00:00:00-03:002020-07-30T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-07-30:/pt-br/post/configurando-o-mbsync-para-usar-xoauth2.html<p>Por um bom tempo eu usei o <a class="reference external" href="https://www.offlineimap.org/">offlineimap</a> para sincronizar meus emails entre os provedores e o meu computador. Ter acesso a todos os meus emails sem precisar de internet é bem útil. Mas depois de ver a <a class="reference external" href="https://people.kernel.org/mcgrof/replacing-offlineimap-with-mbsync">vantagem gigantesca do mbsync em relação ao offlineimap em termos de performance …</a></p><p>Por um bom tempo eu usei o <a class="reference external" href="https://www.offlineimap.org/">offlineimap</a> para sincronizar meus emails entre os provedores e o meu computador. Ter acesso a todos os meus emails sem precisar de internet é bem útil. Mas depois de ver a <a class="reference external" href="https://people.kernel.org/mcgrof/replacing-offlineimap-with-mbsync">vantagem gigantesca do mbsync em relação ao offlineimap em termos de performance</a> e de ter tido problemas de latência com o offlineimap, eu decidi testar o <a class="reference external" href="https://sourceforge.net/projects/isync/">mbsync</a> (o projeto se chama isync, mas o nome do programa que sincroniza os emails é mbsync).</p> <p>O principal problema que eu via em usar o mbsync é que dos três emails que eu uso atualmente, um deles precisa de autenticação via XOAUTH2. Esse mecanismo é suportado nativamente no offlineimap, mas não no mbsync.</p> <div class="section" id="instalacao"> <h2>Instalação</h2> <p>O primeiro passo obviamente foi instalar o isync/mbsync.</p> <p>Em seguida eu instalei uma extensão SASL para o mecanismo XOAUTH2, que no Arch Linux está disponível no AUR como <a class="reference external" href="https://aur.archlinux.org/packages/cyrus-sasl-xoauth2-git/">cyrus-sasl-xoauth2-git</a>.</p> <p>Para que o mbsync consiga autenticar usando XOAUTH2, é necessário um programa que utilize as credenciais da conta para obter o <em>token</em> atual. Para isso eu instalei um pacote python chamado oauth2token, que pode ser instalado do <a class="reference external" href="https://pypi.org/project/oauth2token/">pip</a>, ou diretamente do <a class="reference external" href="https://aur.archlinux.org/packages/oauth2token/">AUR</a>. Obrigado ao <a class="reference external" href="https://github.com/VannTen">VannTen</a> por criar esse pacote e também por me ajudar a resolver alguns problemas em configurar o mbsync para usar XOAUTH2!</p> <p><strong>Obs</strong>: Quando eu instalei o mbsync originalmente, havia um <a class="reference external" href="https://sourceforge.net/p/isync/bugs/55/">problema</a> em usá-lo com XOAUTH2. Mas no momento de publicação desse artigo isso já foi consertado na versão 1.3.2.</p> </div> <div class="section" id="configuracao"> <h2>Configuração</h2> <p>Para configurar o oauth2token eu segui as instruções no <a class="reference external" href="https://github.com/VannTen/oauth2token/blob/master/README.rst">README</a>, que consistem em basicamente criar dois arquivos json com as informações da conta (<code class="docutils literal">client_id</code> e <code class="docutils literal">client_secret</code> devem ser configurados no provedor, no meu caso o Gmail) em um diretório específico, executar <code class="docutils literal">oauth2create &lt;provedor&gt; &lt;conta&gt;</code> e logar na conta de email pelo navegador.</p> <p>Depois de ter configurado o oauth2token, configurar o mbsync pra usá-lo foi bem simples. Eu apenas adicionei <code class="docutils literal">PassCmd &quot;oauth2get &lt;provedor&gt; &lt;conta&gt;&quot;</code> na seção <code class="docutils literal">IMAPAccount</code> do meu <code class="docutils literal">.mbsyncrc</code>, trocando <code class="docutils literal">&lt;provedor&gt;</code> e <code class="docutils literal">&lt;conta&gt;</code> pelos valores que eu utilizei no <code class="docutils literal">oauth2get</code>, claro. No meu caso não foi necessário especificar o mecanismo de autenticação nessa mesma seção usando <code class="docutils literal">AuthMechs XOAUTH2</code>, já que XOAUTH2 é considerado o mecanismo mais seguro instalado, e portanto é o padrão. O que eu precisei fazer foi adicionar <code class="docutils literal">AuthMechs PLAIN</code> na seção <code class="docutils literal">IMAPAccount</code> das outras contas que eu não queria que utilizassem o XOAUTH2.</p> <p>Por fim, executei o mbsync para a conta em que eu configurei o XOAUTH2 (&quot;dac&quot;). A saída verbosa (<code class="docutils literal">-V</code>) mostra que ele autenticou usando XOAUTH2 e tudo funcionou como esperado:</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ mbsync -V dac Reading configuration file /home/nfraprado/.mbsyncrc C: 0/1 B: 0/0 M: +0/0 *0/0 #0/0 S: +0/0 *0/0 #0/0 Channel dac Opening master store dac-remote... Resolving imap.gmail.com... ok Connecting to imap.gmail.com ([2800:3f0:4003:c02::6c]:993)... Opening slave store dac-local... Connection is now encrypted Logging in... Authenticating with SASL mechanism XOAUTH2... C: 0/1 B: 0/5 M: +0/0 *0/0 #0/0 S: +0/0 *0/0 #0/0 Opening master box INBOX... Opening slave box INBOX... Maildir notice: no UIDVALIDITY, creating new. Loading master... master: 0 messages, 0 recent Loading slave... slave: 0 messages, 0 recent Synchronizing... C: 0/1 B: 1/5 M: +0/0 *0/0 #0/0 S: +0/0 *0/0 #0/0 [ ... ] Opening master box _Sent... Opening slave box _Sent... Creating slave _Sent... Maildir notice: no UIDVALIDITY, creating new. Loading master... Loading slave... slave: 0 messages, 0 recent master: 92 messages, 0 recent Synchronizing... C: 1/1 B: 5/5 M: +0/0 *0/0 #0/0 S: +367/367 *0/0 #0/0 </pre> </div> Fazendo um cabo UART para o Nexus 52020-06-30T00:00:00-03:002020-06-30T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-06-30:/pt-br/post/fazendo-um-cabo-uart-para-o-nexus-5.html<p>Recentemente, eu e <a class="reference external" href="https://andrealmeid.com/">um amigo</a> começamos a fuçar em como fazer o Nexus 5 rodar o kernel Linux principal (<a class="reference external" href="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git">diretamente do Linus Torvalds</a>). O objetivo disso é, além de ser uma ótima oportunidade de aprendizado, permitir que o Nexus 5 rode uma distribuição Linux, como o <a class="reference external" href="https://postmarketos.org/">PostmarketOS</a>, ao invés de …</p><p>Recentemente, eu e <a class="reference external" href="https://andrealmeid.com/">um amigo</a> começamos a fuçar em como fazer o Nexus 5 rodar o kernel Linux principal (<a class="reference external" href="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git">diretamente do Linus Torvalds</a>). O objetivo disso é, além de ser uma ótima oportunidade de aprendizado, permitir que o Nexus 5 rode uma distribuição Linux, como o <a class="reference external" href="https://postmarketos.org/">PostmarketOS</a>, ao invés de Android, e ainda receber atualizações por toda a vida do celular.</p> <p>Mas antes de sair programando, primeiro era necessário ter acesso ao UART (serial) do celular no computador, para que eu pudesse ler as mensagens do kernel desde o começo da inicialização e descobrir a fonte de qualquer erro que surgisse. No caso do Nexus 5, o UART fica na saída P2 de áudio, então seria necessária alguma forma de conectar essa saída no USB do meu computador.</p> <p>Eu achei instruções sobre a construção desse cabo na <a class="reference external" href="https://wiki.postmarketos.org/wiki/Serial_debugging:Cable_schematics#Nexus_debug_cable">wiki do postmarketOS</a> e no <a class="reference external" href="https://masneyb.github.io/nexus-5-upstream/UART_CABLE.html">site do nexus-5-upstream</a>, um projeto do Brian Masney, que já contribuiu muito código para fazer o Nexus rodar o kernel principal.</p> <p>Mas como as informações nessas duas páginas eram contraditórias, decidi que seria melhor prototipar o circuito antes e confirmar como funciona, antes de soldar.</p> <div class="section" id="prototipagem"> <h2>Prototipagem</h2> <p>Para o protótipo, eu precisava usar só os componentes que eu já tinha, já que eu já ia precisar comprar componentes para a placa final e não queria fazer duas compras.</p> <p>Decidi seguir o esquemático da <a class="reference external" href="https://wiki.postmarketos.org/wiki/Serial_debugging:Cable_schematics#Nexus_debug_cable">wiki do postmarketOS</a>, já que ele tinha sido baseado em um esquemático do Google.</p> <p>Para o conector P2, eu usei um fone de ouvido velho que estava sobrando, e cortei o fio, ficando com os fios expostos em uma ponta e o conector na outra. Para o divisor de tensão no pino TX, eu usei os mesmos valores de resistência do esquemático, mas usando um resistor de 1kΩ e dois de 100Ω em série para obter o de 1.2kΩ.</p> <p>A conversão entre UART e USB foi feita usando uma placa <a class="reference external" href="https://www.adafruit.com/product/2264">Adafruit FT232H breakout</a> que eu tinha. Já que ela não possui uma saída 3.3V (na minha versão), eu tentei combinar resistores para dividir os 5V. Consegui chegar em 3.26V, mas não funcionou.</p> <p>Já estava quase desistindo, quando lembrei que o Brian Masney escreveu na página dele que <a class="reference external" href="https://masneyb.github.io/nexus-5-upstream/UART_CABLE.html">precisa mesmo ser 3.3V</a>, e também que eu tinha uma placa conversora de SPI para USB com uma saída de 3.3V. Era hora de testar.</p> <p>Depois de um pequeno problema, que foi resolvido simplesmente mudando a taxa de transmissão do serial para 115200, funcionou! 🥳</p> <p>O protótipo ficou assim:</p> <img alt="Protótipo P2 &lt;-&gt; UART &lt;-&gt; USB" src="/images/nexus5-uart/prototype.jpg" /> <p>Eu sei, horrível, mas funciona!</p> <p>Com o protótipo funcionando, eu comprei mais alguns componentes para deixar o circuito mais atraente.</p> </div> <div class="section" id="placa-final"> <h2>Placa final</h2> <p>Os componentes que eu usei para fazer a placa foram:</p> <ul class="simple"> <li>fios</li> <li>1 placa padrão (com pelo menos 9x7 furos)</li> <li>1 resistor de 1kΩ</li> <li>1 resistor de 1.2kΩ</li> <li>1 barra de pinos macho 1x7</li> <li>1 cabo P2 de 4 vias (de um fone de ouvido velho) Obs: <em>precisa</em> ser de <a class="reference external" href="https://en.wikipedia.org/wiki/Phone_connector_(audio)#/media/File:3.5mm.jpg">4 vias</a>.</li> <li>1 <a class="reference external" href="https://www.multcomercial.com.br/placa-ftdi-ft232rl-conversor-usb-serial-arduino-gc-54.html">conversor UART &lt;-&gt; USB</a> (pode ser qualquer um de 3.3V)</li> </ul> <p>Apenas para referência, os pinos devem ser conectados assim (mas é melhor de visualizar no <a class="reference external" href="https://wiki.postmarketos.org/wiki/Serial_debugging:Cable_schematics#Nexus_debug_cable">esquemático do postmarketOS</a>):</p> <table border="1" class="docutils"> <colgroup> <col width="20%" /> <col width="48%" /> <col width="31%" /> </colgroup> <thead valign="bottom"> <tr><th class="head">Pino de UART</th> <th class="head">Entre</th> <th class="head">Pino do P2</th> </tr> </thead> <tbody valign="top"> <tr><td>RX</td> <td>—</td> <td>Ponta (TX)</td> </tr> <tr><td>TX (com 3.3V)</td> <td>Divisor de tensão (1kΩ e 1.2kΩ)</td> <td>Anel 1 (RX com 1.8V)</td> </tr> <tr><td>GND</td> <td>—</td> <td>Anel 2</td> </tr> <tr><td>3.3V</td> <td>—</td> <td>Base</td> </tr> </tbody> </table> <p>Eu gastei um pouco de tempo pensando qual seria a melhor posição das conexões e resistores na placa, e decidi soldar assim:</p> <img alt="Conexões na PCB" src="/images/nexus5-uart/lower.jpg" /> <p>As ligações no verso da placa e pinos correspondentes podem ser vistos a seguir:</p> <img alt="Conexões na PCB com indicações" src="/images/nexus5-uart/lower_annotated_br.jpg" /> <p>Como a PCB era maior que a placa do conversor, eu serrei ela até ficar com mais ou menos o mesmo tamanho (17x7), mas as conexões ocupam só 9x7.</p> <p>Também mudei a posição do jumper da placa conversora para que o VCC ficasse com 3.3V.</p> <p>E por fim soldei a barra de pinos na placa conversora e sobre a minha PCB, resultando em uma placa de 2 andares bem estilosa 😎.</p> <p>A placa final ficou assim:</p> <img alt="Placa final vista de cima" src="/images/nexus5-uart/final_top.jpg" /> <img alt="Placa final vista de lado" src="/images/nexus5-uart/final_side.jpg" /> </div> <div class="section" id="testando"> <h2>Testando</h2> <p>Depois de conectar o USB da placa no meu computador e o P2 no Nexus 5, eu abri o console serial usando o <code class="docutils literal">picocom</code> com uma taxa de transmissão de 115200:</p> <div class="highlight"><pre><span></span>picocom<span class="w"> </span>/dev/ttyUSB0<span class="w"> </span>-b<span class="w"> </span><span class="m">115200</span> </pre></div> <p>E liguei o Nexus 5 no modo fastboot segurando os botões de energia e de abaixar volume, sendo recebido por essa mensagem calorosa:</p> <pre class="literal-block"> welcome to hammerhead bootloader [10] Power on reason 80 [10] DDR: hynix [110] Loaded IMGDATA at 0x11000000 [110] Display Init: Start [190] MDP GDSC already enabled [190] bpp 24 [230] Config MIPI_CMD_PANEL. [230] display panel: ORISE [230] display panel: Default setting [360] Turn on MIPI_CMD_PANEL. [410] Display Init: Done [410] cable type from shared memory: 8 [410] vibe [610] USB init ept &#64; 0xf96b000 [630] secured device: 1 [630] fastboot_init() [680] splash: fastboot_op FASTBOOT MODE PRODUCT_NAME - hammerhead VARIANT - hammerhead D821(H) 16GB HW VERSION - rev_11 BOOTLOADER VERSION - HHZ20h BASEBAND VERSION - M8974A-2.0.50.2.30 CARRIER INFO - None SERIAL NUMBER - *** SIGNING - production SECURE BOOT - enabled LOCK STATE - unlocked [790] splash: start [1820] Fastboot mode started [1820] udc_start() </pre> <p>Já que eu verifiquei que os pinos do <a class="reference external" href="https://masneyb.github.io/nexus-5-upstream/UART_CABLE.html">nexus-5-upstream</a> estavam errados, mandei uma <a class="reference external" href="https://github.com/masneyb/nexus-5-upstream/pull/4">mudança de código</a> consertando, então agora não deve haver mais confusão 😉.</p> <p>Beleza! Agora que eu eu consigo ler todas as mensagens de inicialização, estou pronto para mergulhar no código do kernel. Apesar que certamente essa foi a parte mais fácil do projeto 😅...</p> </div> Criando listas de filmes e jogos usando Taskwarrior2020-05-25T00:00:00-03:002020-05-25T00:00:00-03:00Nícolas F. R. A. Pradotag:nfraprado.net,2020-05-25:/pt-br/post/criando-listas-de-filmes-e-jogos-usando-taskwarrior.html<p>Eu gosto de assistir filmes e jogar jogos, mas também gosto de registrar quais filmes já assisti e quais jogos já zerei. Fora isso, acabei desenvolvendo o hábito de dar uma nota para cada filme que assisto.</p> <p>Alguns anos atrás eu comecei a tentar me manter mais focado e organizado …</p><p>Eu gosto de assistir filmes e jogar jogos, mas também gosto de registrar quais filmes já assisti e quais jogos já zerei. Fora isso, acabei desenvolvendo o hábito de dar uma nota para cada filme que assisto.</p> <p>Alguns anos atrás eu comecei a tentar me manter mais focado e organizado usando um gerenciador de lista de afazeres <em>CLI</em> (com interface de linha de comando) chamado <a class="reference external" href="https://taskwarrior.org/">Taskwarrior</a>. De repente caiu a ficha que eu também poderia usar essa ferramenta sensacional para registrar essas listas de filmes e jogos!</p> <div class="section" id="configuracao-do-taskwarrior"> <h2>Configuração do Taskwarrior</h2> <p>Se você já conhece o Taskwarrior, então você já sabe que tudo que ele precisa é de um arquivo de configuração (normalmente um <code class="docutils literal">.taskrc</code> na sua pasta home), e uma pasta para manter seus dados.</p> <p>Para manter essas listas separadas das minhas tarefas do Taskwarrior, eu decidi criar uma pasta (<code class="docutils literal">/home/nfraprado/txt/todo</code>) separada, com um arquivo de configuração (<code class="docutils literal">config</code>) e uma pasta para os dados (<code class="docutils literal">data</code>).</p> <p>Dentro do <code class="docutils literal">config</code>, primeiro eu defini a pasta de dados:</p> <div class="highlight"><pre><span></span><span class="na">data.location</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">/home/nfraprado/txt/todo/data</span> </pre></div> <p>Então removi a cor de tarefas rotuladas e tornei a busca independente de maiúsculas e minúsculas:</p> <div class="highlight"><pre><span></span><span class="na">color.tagged</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">none</span> <span class="na">search.case.sensitive</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">no</span> </pre></div> <p>Eu também criei um <em>UDA</em>, atributo definido pelo usuário, chamado Score, para que eu pudesse adicionar uma nota para um filme após assisti-lo:</p> <div class="highlight"><pre><span></span><span class="na">uda.score.type</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">numeric</span> <span class="na">uda.score.label</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Score</span> </pre></div> <p>Finalmente, adicionei os relatórios (<em>reports</em>) de filmes e de jogos. Cada relatório pode ter um filtro configurado, determinando quais tarefas serão exibidas nele, e também suas colunas, determinando quais atributos das tarefas serão mostrados, além de outras configurações.</p> <p>Para os jogos, eu queria dois relatórios: um chamado <code class="docutils literal">games.todo</code>, mostrando os jogos que eu ainda pretendo zerar, e outro chamado <code class="docutils literal">games.done</code> com os jogos que já zerei:</p> <div class="highlight"><pre><span></span><span class="c1"># Games reports</span> <span class="na">report.games.todo.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Games to complete</span> <span class="na">report.games.todo.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Title</span> <span class="na">report.games.todo.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,description</span> <span class="na">report.games.todo.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:pending limit:page project:games</span> <span class="na">report.games.done.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Games completed</span> <span class="na">report.games.done.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Title,Completed on</span> <span class="na">report.games.done.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">description,end</span> <span class="na">report.games.done.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:completed limit:page project:games</span> <span class="na">report.games.done.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">end-</span> </pre></div> <p>Já para os filmes, eu também adicionei os relatórios de <code class="docutils literal">todo</code> e <code class="docutils literal">done</code>, com a diferença de que o <code class="docutils literal">done</code> também possui uma coluna com o <code class="docutils literal">score</code> (<em>UDA</em> criado anteriormente) para que eu possa ver qual nota dei para cada filme que já assisti. Além disso, também adicionei um relatório <code class="docutils literal">movies.rank</code> que é ordenado com base na nota, assim posso ter uma lista dos meus filmes favoritos 🙂:</p> <div class="highlight"><pre><span></span><span class="c1"># Movies reports</span> <span class="na">report.movies.todo.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Movies to watch</span> <span class="na">report.movies.todo.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">ID,Tags,Title</span> <span class="na">report.movies.todo.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">id,tags,description</span> <span class="na">report.movies.todo.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:pending limit:page project:movies</span> <span class="na">report.movies.done.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Movies seen</span> <span class="na">report.movies.done.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Title,Tags,Score,Watched on</span> <span class="na">report.movies.done.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">description,tags,score,end</span> <span class="na">report.movies.done.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:completed limit:page project:movies</span> <span class="na">report.movies.done.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">end-</span> <span class="na">report.movies.rank.description</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Movies ranking</span> <span class="na">report.movies.rank.labels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">Title,Tags,Score</span> <span class="na">report.movies.rank.columns</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">description,tags,score</span> <span class="na">report.movies.rank.filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">status:completed limit:page project:movies</span> <span class="na">report.movies.rank.sort</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">score-</span> </pre></div> </div> <div class="section" id="configuracao-do-bash"> <h2>Configuração do Bash</h2> <p>Com o Taskwarrior configurado, só o que faltava eram alguns atalhos no meu <code class="docutils literal">.bashrc</code> para que fosse mais conveniente adicionar, completar e ver os filmes e jogos.</p> <p>Dentro do meu <code class="docutils literal">.bashrc</code>, primeiro adicionei uma variável apontando para o arquivo de configuração:</p> <div class="highlight"><pre><span></span><span class="nv">TODOCONFIG</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$HOME</span><span class="s2">/txt/todo/config&quot;</span> </pre></div> <p>Então adicionei os atalhos para adicionar, listar e listar completos tanto para os jogos quanto para os filmes. Também adicionei um para marcar um jogo como completo e um para ver o ranking de filmes. Em todos esses comandos, usei <code class="docutils literal">rc:$TODOCONFIG</code> para que o Taskwarrior use o arquivo de configuração que adicionei antes. Para os atalhos de adicionar e marcar como completo, apenas utilizei os comandos <code class="docutils literal">add</code> e <code class="docutils literal">done</code> do Taskwarrior, respectivamente. A listagem é feita simplesmente utilizando os relatórios anteriormente definidos:</p> <div class="highlight"><pre><span></span><span class="c1"># Games list</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">gamadd</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG add project:games&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">gamlist</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG games.todo&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">gamlistdone</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG games.done&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">gamdone</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG done&#39;</span> <span class="c1"># Movies list</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">movadd</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG add project:movies&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">movlist</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG movies.todo&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">movlistdone</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG movies.done&#39;</span> <span class="nb">alias</span><span class="w"> </span><span class="nv">movrank</span><span class="o">=</span><span class="s1">&#39;task rc:$TODOCONFIG movies.rank&#39;</span> </pre></div> <p>O atalho para completar um filme não pode ser feito diretamente, já que eu também quero poder dar uma nota ao completá-lo. Por isso criei uma simples função em Bash que recebe o ID da tarefa e a nota, aplica a nota dada na tarefa e a marca como completa:</p> <div class="highlight"><pre><span></span>movdone<span class="o">()</span> <span class="o">{</span> <span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>-z<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$1</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">]</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>-z<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$2</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">]</span><span class="p">;</span><span class="k">then</span> <span class="w"> </span><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;Usage: movdone id score&quot;</span> <span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="m">1</span> <span class="w"> </span><span class="k">fi</span> <span class="w"> </span>task<span class="w"> </span>rc:<span class="nv">$TODOCONFIG</span><span class="w"> </span>modify<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$1</span><span class="s2">&quot;</span><span class="w"> </span>score:<span class="s2">&quot;</span><span class="nv">$2</span><span class="s2">&quot;</span> <span class="w"> </span>task<span class="w"> </span>rc:<span class="nv">$TODOCONFIG</span><span class="w"> </span><span class="k">done</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$1</span><span class="s2">&quot;</span> <span class="o">}</span> </pre></div> </div> <div class="section" id="resultado"> <h2>Resultado</h2> <p>Com toda essa configuração feita, eu finalmente podia registrar meus filmes e jogos facilmente.</p> <p>Adicionar um novo filme para assistir é tão simples quanto um <code class="docutils literal">movadd nome_do_filme</code> (espaços no nome do filme podem ser usados sem problema).</p> <p>E depois de assistir um filme, posso marcá-lo como finalizado e dar uma nota com um <code class="docutils literal">movdone id nota</code>. O <code class="docutils literal">id</code> de um filme pode ser obtido usando <code class="docutils literal">movlist</code>.</p> <p>Esses são os filmes que eu planejo assistir:</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ movlist Using alternate .taskrc file /home/nfraprado/txt/todo/config ID Title 23 Once Upon a Time In Hollywood 27 Ready player one 28 In The Shadow Of The Moon 2007 </pre> <p>Os últimos 5 filmes que assisti:</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ movlistdone Using alternate .taskrc file /home/nfraprado/txt/todo/config Title Tags Score Watched on Arrival 8 2020-05-25 The Green Mile 8 2020-05-17 The Boy Who Harnessed the Wind 8 2020-04-25 Jojo Rabbit 6 2020-04-18 Back to the Future 8 2020-04-12 </pre> <p>Os filmes que dei a maior nota (desde que criei essa lista):</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ movrank Using alternate .taskrc file /home/nfraprado/txt/todo/config Title Tags Score The Lord of the Rings: The Return of the King 10 The Lord of the Rings: The Two Towers 10 The Lord of the Rings: The Fellowship of the Ring 10 Whisper of the Heart ghibli 9 Apollo 11 doc 9 Life is beautiful 9 Koe no katachi 9 </pre> <p>Alguns jogos que pretendo zerar:</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ gamlist Using alternate .taskrc file /home/nfraprado/txt/todo/config ID Title 6 FTL 7 The Witness 8 Factorio 9 Stardew Valley 10 Half Life </pre> <p>E os últimos 5 jogos que eu zerei:</p> <pre class="literal-block"> [nfraprado&#64;ArchWay ~]$ gamlistdone Using alternate .taskrc file /home/nfraprado/txt/todo/config Title Completed on The Stanley Parable 2020-04-24 Undertale 2020-04-17 Cave Story 2020-03-30 Antichamber 2020-03-22 Papers, Please 2020-03-19 </pre> </div>