Plugin para Obsidian
Aktar para Obsidian
Mantenha suas notas leves e seus anexos no seu próprio bucket S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces ou MinIO. Cole ou solte um arquivo e ele vai para o bucket, mova os anexos que você já tem, e cada link é uma URL https:// simples que funciona com ou sem o plugin.
Grátis e de código aberto. Desktop, iPhone, iPad e Android, Obsidian 1.11.4 ou posterior.
Links simples, sem amarras
O Aktar reescreve a incorporação como uma imagem Markdown padrão com a URL do bucket. O tamanho e a legenda continuam, e a nota fica com a mesma aparência.
![[IMG_2041.png|300]]- As notas continuam com poucos kilobytes e sincronizando como hoje, com Obsidian Sync, iCloud, Git ou o que você usar.
- O link funciona em qualquer app de Markdown, no GitHub, no navegador e no Obsidian sem o plugin. Desinstale e nada quebra.
- Mudou de ideia? Bring files back baixa os arquivos para o cofre e transforma os links de novo em links de anexo comuns.
Tudo o que ele faz
O plugin usa os mesmos destinos, modelos de caminho e regras dos apps do Aktar, então um arquivo enviado pelo Obsidian vai parar no mesmo lugar que um enviado pelo Mac ou pelo celular.
-
Colar e soltar
Um arquivo colado ou solto entra na nota na hora como um marcador e vira um link quando o envio termina. Escolha o que vai para o bucket ao colar ou soltar: imagens, todos os arquivos ou nada, e defina uma largura padrão para novas imagens incorporadas.
-
Mover anexos existentes
Mova os anexos de uma nota ou do cofre inteiro. Uma simulação lista cada arquivo e cada nota que muda antes de qualquer coisa acontecer. Links no front matter, em blocos de código e em canvas ficam como estão, assim como os arquivos deles. As cópias locais vão para a lixeira, ou ficam, se você preferir.
-
Desfazer qualquer movimentação
Undo the last move to the bucket baixa os arquivos de volta para o cofre e deixa cada link exatamente como era.
-
Trazer arquivos de volta
Baixe os arquivos de uma nota do bucket para o cofre. Os links viram links de anexo comuns, escritos como mandam as suas configurações de link do Obsidian: wikilinks ou Markdown, caminho mais curto ou relativo.
-
Mover novos anexos automaticamente
Fotos anexadas no celular, ou arquivos que outros plugins salvam no cofre, vão para o bucket assim que uma nota os incorpora. Arquivos que nenhuma nota usa ficam onde estão. Se quiser, limite isso a uma pasta.
-
Buckets privados
Suas notas mantêm links simples, e o plugin mostra os arquivos por URLs assinadas no seu dispositivo, válidas por uma hora. Ninguém sem as suas chaves consegue abri-los.
-
A biblioteca
Um painel lateral com três visões: quais arquivos do bucket suas notas usam e onde, as pastas e arquivos do bucket, e a fila de envios. Encontre os arquivos que nenhuma nota usa mais e apague todos de uma vez, depois de uma confirmação.
-
Ações de link
Clique com o botão direito num link para copiá-lo, copiar um link válido por 1 hora, 1 dia ou 7 dias, abri-lo, trazer o arquivo para o cofre ou excluí-lo do bucket. Antes de excluir, ele mostra quais notas usam o arquivo.
-
Fotos menores
Converta fotos para WebP antes do envio, cerca de um terço do tamanho de um JPEG com a mesma qualidade, e reduza para 3840, 2560, 1920, 1280 ou 1024 pixels. GIFs e SVGs não são alterados. Onde o dispositivo não gera WebP (iPhone, iPad), as fotos viram JPEG.
-
Sem localização nas suas fotos
O lugar onde a foto foi tirada é removido antes de ela sair do dispositivo. A imagem em si não é alterada.
-
Funciona offline
As imagens que você já viu ficam guardadas no dispositivo, até o tamanho que você escolher, então as notas mostram essas imagens sem conexão. Os envios esperam numa fila que sobrevive a ficar offline e a reiniciar o Obsidian, e sobem sozinhos quando a conexão volta.
-
Funciona com o app do Aktar
Num Mac ou PC com o Aktar, conecte o plugin ao app com um clique. Os envios passam a ir pelo Aktar, com os destinos, chaves, histórico e hooks dele, e o Obsidian nunca vê as chaves.
-
Publicar uma nota
Transforme uma nota numa página web no seu bucket, com as imagens, e o link é copiado. Escolha um link permanente ou um que funciona por 7 dias (sempre 7 dias num bucket privado). A página não pode rodar scripts, e Take down a remove.
-
Backup do cofre
Um zip do cofre inteiro vai para o seu bucket todo dia ou toda semana, com um nome que ninguém adivinha, guardando os 3, 7, 14 ou 30 mais recentes. Ative no dispositivo que fica ligado mais tempo. A pasta de configurações do Obsidian fica de fora, a menos que você a inclua, porque outros plugins podem guardar senhas nela.
-
Sua estrutura de pastas
Por padrão, cada cofre ganha uma pasta própria no bucket,
obsidian/{vault}/{year}/{month}/{short}.{ext}. Use o nome ou a pasta da nota, datas, o nome original do arquivo ou um código curto. Arquivos movidos recebem nomes que dependem só do arquivo, então dois dispositivos sincronizados que movem o mesmo arquivo gravam o mesmo objeto e os mesmos links. -
Em todos os dispositivos
O mesmo plugin roda no Mac, Windows e Linux, e no Obsidian para iPhone, iPad e Android. Os destinos sincronizam com o cofre; as chaves não, e cada dispositivo as recebe uma vez com um código de transferência.
Configure
Instale o Aktar pelos plugins da comunidade do Obsidian (Settings › Community plugins › Browse) e ative-o. Depois adicione um destino de uma destas três formas.
De um app do Aktar
- No Aktar do seu Mac, PC, iPhone ou celular Android, abra um destino e escolha Transferir para outro dispositivo. Copie o link de transferência.
- No Obsidian, abra Settings › Aktar › Add from Aktar app. O link é preenchido a partir da área de transferência.
- Digite o código de 12 caracteres que o Aktar mostra. As chaves chegam criptografadas e o destino está pronto.
Conectar ao Aktar deste computador
- Instale o Aktar para Mac 0.19 ou para Windows 0.12 ou posterior e adicione um destino nele.
- No Obsidian, abra Settings › Aktar › Aktar app e clique em Connect.
- Clique em Connect na janela que o Aktar mostra. Os destinos dele aparecem no plugin, e os envios passam pelo app.
Digitar à mão
- Escolha Add manually em Settings › Aktar.
- Informe o endpoint, o bucket, a região, a URL pública e as chaves. Os guias de configuração mostram onde encontrar cada um em cada provedor.
- Teste a conexão e salve.
Comandos
Toda ação está na paleta de comandos, então você pode dar um atalho a ela em Settings › Hotkeys. As mais usadas também estão no menu de clique direito do editor.
- Upload a file into this note
- Escolha um arquivo e envie para a nota, na posição do cursor.
- Move this note’s attachments to the bucket
- Move os anexos da nota aberta, depois de uma simulação.
- Move attachments to the bucket…
- Move os anexos do cofre inteiro ou de uma pasta, depois de uma simulação.
- Bring this note’s files back into the vault
- Baixa para o cofre os arquivos do bucket usados pela nota aberta e transforma os links em links de anexo.
- Undo the last move to the bucket
- Desfaz a última movimentação: os arquivos voltam e os links ficam como eram.
- Open the library
- Abre a biblioteca no painel lateral.
- Publish this note as a web page
- Transforma a nota aberta numa página web no seu bucket e copia o link.
- Take down this note’s web page
- Remove do bucket a página web da nota aberta.
- Back up the vault now
- Compacta o cofre e o envia ao bucket agora, independentemente da programação.
- Retry uploads
- Tenta de novo os envios que estão esperando.
- Save failed uploads into the vault instead
- Salva no cofre os envios que continuam falhando, para que nada se perca.
- Add a destination from an Aktar app
- Adiciona um destino a partir de um link e um código de transferência.
Suas chaves ficam no dispositivo
Os destinos são salvos nas configurações do plugin, que sincronizam com o cofre. As chaves nunca vão para lá. Elas ficam no armazenamento de segredos do Obsidian em cada dispositivo, que não sincroniza, então um cofre que você compartilha ou coloca no Git não leva chave nenhuma.
Um dispositivo que tem um destino mas não as chaves dele avisa e pede um código de transferência. Conectado ao app do Aktar, o Obsidian nunca chega a ver as chaves.
Com o que ele se conecta
Só com os endpoints de armazenamento e as URLs públicas dos destinos que você adiciona e, no desktop, com o app do Aktar em 127.0.0.1, se você conectar os dois. Não há servidor do Aktar no meio, nem conta, nem análises, nem telemetria.
Ele lista os arquivos do cofre para saber quais notas usam qual arquivo, e só os arquivos que você envia, move ou inclui no backup vão para o seu bucket. Ele lê a área de transferência uma vez, quando você abre Add from Aktar app, para preencher o link de transferência.
Requisitos
- Obsidian 1.11.4 ou posterior no Mac, Windows, Linux, iPhone, iPad ou Android
- Um bucket no Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO ou outro serviço compatível com S3, com URL pública ou privado
- Opcional: Aktar para Mac 0.19 ou para Windows 0.12 ou posterior, para conectar com um clique
Perguntas
Minhas notas continuam funcionando sem o plugin?
Sim. Cada link é um link Markdown simples para o seu bucket, então as notas mostram as imagens em qualquer app de Markdown, na web e no Obsidian sem o Aktar. Só os arquivos num bucket privado precisam do plugin, porque precisam de uma URL assinada.
O que acontece com os arquivos do meu cofre?
Quando são movidos, as cópias locais vão para a lixeira do Obsidian, ou ficam se você escolher Keep it in the vault too. Arquivos que nenhuma nota usa, e arquivos usados no front matter, em código ou em canvas, ficam onde estão.
Dá para voltar atrás?
Sim. Desfaça a última movimentação, traga de volta os arquivos de uma nota ou traga um arquivo de cada vez pelo menu de um link. Os arquivos descem do seu bucket e os links voltam a ser links de anexo comuns.
Funciona com Obsidian Sync, iCloud ou Git?
Sim. Ele não substitui a sua sincronização, só deixa menor o que é sincronizado. Dois dispositivos que movem o mesmo arquivo gravam o mesmo objeto e o mesmo link, então não brigam por ele.
Quanto custa?
O plugin é grátis e de código aberto. Você paga ao seu provedor de armazenamento pelo que guarda, e com o Cloudflare R2 não há cobrança por downloads.