sanjarcode / obsidian-attachment-name-formatting Goto Github PK

This plugin will format all attachments in the format: "notename attachmentFormat indexNumber.xxx"

The attachmentFormat are image, audio, video and pdf. IndexNumber is ascending number from 1 based on the attchmentFormat.You can change the default format for different type of attachments and the connector in the setting. Basically, there are three types of format:

1. notename attachmentFormat indexNumber.xxx
2. notename attachmentFormat indexNumber time.xxx
3. attachmentFormat indexNumber time.xxx

The space in between can be set by your choice, even use nothing in between.

There is a one-in-many situation, which means using the same attachment in many different notes. In this plugin, it gives three options to handle this situation:

1. Default: Always rename with the note name;
2. Copy: Create a copy for the attachment and rename with the new note name;
3. NoChange: Stick to the first time that attachment is renamed, and will not occupy index number

When using "Copy" mode, it will take a bit longer time than usual renaming time, around 1-2s. For "NoChange" mode, if you want to rename the attachment after it's renamed by this plugin, you need to rename it by yourself in the valut or in the file system right now. May add a Command later to handle this.

Note: The base path of the attachments is based on the Valut setting: Files & Linsk -> Attachment folder path.

• Format attachments in active file, such as "notename image 1.png". It can also add modify time after index, such as "notename image 1 20220101000000.png", defualt setting is not adding time. You can also exclude the notename in the attachment notename, but the time suffix will be added automatically.
• Format attachmnets in selected folder
• Format attachments with customize subfolder for each attachment type
• Attachment name can be customized for each type of attachment, you can use any character that allowed in a note name
• Connector (the character between notename, attachmentFormat, indexNumber and time) can be customized, you can use any character that allowed in a note name. You can also customized different connectors seperately or even don't use connector.
• Add new attachment -> will rename the attachment based on type and index
• Change order -> will rename attachments with new order
• Delete attachment -> will rename attachments with new order

• Export attachmnets in current file and save as a zip file (can be deleted after export), only avaliable in desktop now
• Export unused attachment in the vault and save as a zip file (can be deleted after export), only avaliable in desktop now

1. Image files: png, webp, jpg, jpeg, gif, bmp, svg
2. Audio files: mp3, wav, m4a, ogg, 3gp, flac
3. Video files: mp4, webp, ogv, mov, mkv
4. PDF files: pdf

webm file type will be regard as vedieo even if it can be audio.

• When delete an attachment which is already renamed, it will not rename and will occupy the indexNmuber for this note. But will be renamed to tmp_xxx if there is a conflict later.
• When there are two attachments have same name but in different paths, the function will not work correctly. Try to not change the setting "Files & Links -> Default location for new attachments".

• When deleting attachment in a file, rename it with "notename attachmentFormat unuse 1.xxx".
• When deleting an attachment that no other file using this attachment, delete it from vault. (Could be disable)
• Support the situation that attachments have same name but under different path.

1. Setup change log tool

npm install -g commitizen
npm install -g conventional-changelog-cli

2. Update change log

git add .
git cz

3. Update version

npm run version --new=<new_version>

4. Push tag

git push origin --tag

MIT